List workspace roles
You're viewing API version
2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.GET
Returns the workspace roles defined on the workspace bound to the current API token, including the permission keys each role grants and how many members hold it. Use the id values when calling addMember or updateMember; role names are user-editable and not stable across renames.
Permission required: MANAGE_WORKSPACE_ROLES on the workspace.
header
AuthorizationBearer <token>Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
Workspace roles available on the current workspace
application/json- response
Workspace roles available on the current workspace
roles*array<>curl -X GET 'https://app.sajn.se/api/v1/workspace-roles' \ -H 'authorization: string'Example Response
{ "roles": [ { "id": "string", "name": "string", "isDefault": true, "permissions": [ "READ_DOCUMENT" ], "memberCount": 0, "createdAt": null, "updatedAt": null } ]}Was this page helpful?