Skip to Content

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
/api/v1/workspace-roles

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.

Authorization

headerAuthorizationBearer <token>

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Header Parameters

authorization*string

Bearer token for API authentication

Response Body

Workspace roles available on the current workspace

application/json
  1. response

Workspace roles available on the current workspace

roles*array<>
Example Request
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?