Workspace configuration
List workspace members
Lists everyone in the workspace, 100 at a time, with their role, licences and whether they are active. Use it to pick a person for an assignment or to audit access.
Requires: desk.read scope.
Authorization
bearerAuth AuthorizationBearer <token>
A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.
In: header
Query Parameters
limit?integer
Page size: 100 by default, and 100 at most. A larger value is treated as 100.
cursor?string
next_cursor from the previous page. Leave it out for the first page.
Response
OK
Example
{ "data": [ { "user_id": "ba7d8e12-8a4f-478d-9d10-86689fa3b682", "email": "amina@example.com", "name": "Amina Wanjiru", "role": "agent", "joined_at": "2026-10-14T08:30:00Z", "deactivated": false, "deactivated_at": "2026-10-14T08:30:00Z", "last_membership": false, "display_name": "Amina Wanjiru", "desk_active_at": "2026-10-14T08:30:00Z", "cleanup_pending": false, "billable": false, "invited_by": "Wanjiku Mwangi", "invited_by_user_id": "ab9a27be-755d-4550-9f9b-788360b0874a", "invited_at": "2026-10-14T08:30:00Z", "invited_via": "example" } ], "next_cursor": "eyJvIjoyNX0", "has_more": false}FieldTypeDescription
datarequiredobject[]user_idrequiredstringThe id of the person.emailrequiredstringAn email address.namerequiredstringA name for it.rolerequiredstringThe role: admin, agent or viewer.joined_atrequiredstringdeactivatedrequiredbooleandeactivated_atstringlast_membershipbooleandisplay_namerequiredstringThe name shown for this person across SautiDesk.desk_active_atrequiredstring | nullcleanup_pendingbooleanbillablerequiredbooleaninvited_bystringinvited_by_user_idstringinvited_atstringinvited_viastringnext_cursorrequiredstring | nullhas_morerequiredbooleancurl -X GET "https://api.sautidesk.com/v1/desk/members"