Team and licences
Set a team member's licences
Sets which Desk licences a member has: converse for tickets and conversations, contacts for the address book, supervisor for reports and listening in. Owners and admins always have every licence.
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", "role": "agent", "licences": [ "converse" ]}FieldTypeDescription
user_idrequiredstringThe id of the person.rolerequiredstringThe role: admin, agent or viewer.licencesrequiredstring[]The Desk licences to give: converse (tickets and conversations), contacts (the address book) and supervisor (reports and listening in).curl -X PUT "https://api.sautidesk.com/v1/memberships/string/licences" \ -H "Content-Type: application/json" \ -d '{ "licences": [ "converse" ] }'