v1

latestOpenAPI 3.1.02026-07-223614164.6 KB
Users

List users

Returns a list of workspace users.

get/v1/users

Query parameters

limitinteger

The number of items to return.

cursorstring

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.

Response

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

deprecationsstring[]

Example response

{
  "data": {
    "items": [
      {
        "id": "usr_bc984b3f-0386-434d-82d7-a91eb6badd71",
        "fullName": "John Doe",
        "email": "john.doe@example.com"
      }
    ],
    "pagination": {
      "nextLink": "https://api.folk.app/v1/users?limit=20&cursor=eyJvZmZzZXQiOjIwfQ%3D%3D"
    }
  },
  "deprecations": [
    "This field is deprecated"
  ]
}