GET
/
v1
/
groups
curl --request GET \
  --url https://api.folk.app/v1/groups \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "items": [
      {
        "id": "grp_bc984b3f-0386-434d-82d7-a91eb6badd71",
        "name": "Group Name"
      }
    ],
    "pagination": {
      "nextLink": "https://api.folk.app/v1/groups?limit=20&cursor=eyJvZmZzZXQiOjIwfQ%3D%3D"
    }
  }
}

Authorizations

​
Authorization
string
header
required

API key for authentication

Query Parameters

​
limit
integer
default:20

The number of items to return.

Required range: 1 <= x <= 100
​
cursor
string

A cursor for pagination across multiple pages of results. Don’t include this parameter on the first call. Use the pagination.nextLink value returned in a previous response to request subsequent results.

Maximum length: 128

Response

200
application/json

A paginated list of groups in the workspace. The data.items field contains the list of groups, and the data.pagination.nextLink field contains a link to the next page of results, if available.

The response is of type object.