List workspace roles
curl --request GET \
--url https://{platformHost}/api/public/v1/workspaces/{workspaceId}/roles \
--header 'X-API-Key: <api-key>'{
"success": true,
"data": {
"roles": [
{
"roleId": "builtin.workspace.restricted_member",
"name": "RESTRICTED_MEMBER",
"assignableAt": [
"workspace"
],
"permissions": [
"<string>"
],
"effectivePermissions": [
"<string>"
],
"assignableByCaller": true,
"id": "<string>",
"description": "<string>",
"parentRoleId": "<string>",
"apiAssignable": true,
"reasons": [
"<string>"
],
"revision": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
]
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "<string>",
"messages": [
"<string>"
],
"retryable": true,
"details": {}
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "<string>",
"messages": [
"<string>"
],
"retryable": true,
"details": {}
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "<string>",
"messages": [
"<string>"
],
"retryable": true,
"details": {}
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "<string>",
"messages": [
"<string>"
],
"retryable": true,
"details": {}
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "<string>",
"messages": [
"<string>"
],
"retryable": true,
"details": {}
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "<string>",
"messages": [
"<string>"
],
"retryable": true,
"details": {}
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "<string>",
"messages": [
"<string>"
],
"retryable": true,
"details": {}
}
}List workspace roles
List the built-in workspace roles with their permissions and whether a platform key can assign each one.
GET
/
api
/
public
/
v1
/
workspaces
/
{workspaceId}
/
roles
List workspace roles
curl --request GET \
--url https://{platformHost}/api/public/v1/workspaces/{workspaceId}/roles \
--header 'X-API-Key: <api-key>'{
"success": true,
"data": {
"roles": [
{
"roleId": "builtin.workspace.restricted_member",
"name": "RESTRICTED_MEMBER",
"assignableAt": [
"workspace"
],
"permissions": [
"<string>"
],
"effectivePermissions": [
"<string>"
],
"assignableByCaller": true,
"id": "<string>",
"description": "<string>",
"parentRoleId": "<string>",
"apiAssignable": true,
"reasons": [
"<string>"
],
"revision": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
]
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "<string>",
"messages": [
"<string>"
],
"retryable": true,
"details": {}
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "<string>",
"messages": [
"<string>"
],
"retryable": true,
"details": {}
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "<string>",
"messages": [
"<string>"
],
"retryable": true,
"details": {}
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "<string>",
"messages": [
"<string>"
],
"retryable": true,
"details": {}
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "<string>",
"messages": [
"<string>"
],
"retryable": true,
"details": {}
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "<string>",
"messages": [
"<string>"
],
"retryable": true,
"details": {}
}
}{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "<string>",
"messages": [
"<string>"
],
"retryable": true,
"details": {}
}
}assignableByCaller before you assign a role. It is the source of truth. When a role isn’t assignable, the reasons field says why. A key can assign only builtin.workspace.restricted_member and builtin.workspace.workbench_manager. The request needs the workspace.roles.read scope.Was this page helpful?