Team and licences
Change a team member's role
Changes a team member's role or display_name. The owner's role cannot be changed this way.
Requires: desk.admin scope, workspace owner or admin.
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
Path Parameters
user_id*string
The id (a UUID) of the person.
Request Body
application/json
Response
OK
Example
{ "user_id": "ba7d8e12-8a4f-478d-9d10-86689fa3b682", "workspace_id": "0d16f37b-483b-4345-9876-083e209b25ee", "role": "agent", "created_at": "2026-10-14T08:30:00Z", "display_name": "Amina Wanjiru"}FieldTypeDescription
user_idrequiredstringThe id of the person.workspace_idrequiredstringrolerequiredstringThe role: admin, agent or viewer.created_atrequiredstringdisplay_namestringThe name shown for this person across SautiDesk.curl -X PATCH "https://api.sautidesk.com/v1/memberships/string" \ -H "Content-Type: application/json" \ -d '{ "role": "agent", "display_name": "Amina Wanjiru" }'