Skip to content

Organization and team role definitions.

GET/org/roles

List organization roles

Returns all roles available within the organization, including their names and descriptions. Organization roles define the permissions a member has at the organization level.

Parameters

pageinteger
page

The page number to retrieve (1-indexed). Used with limit to support offset-based pagination.

Type
integer
Format
"int32"
Minimum
1
Default
1
limitinteger
limit

The maximum number of items to list.

Type
integer
Format
"int32"
Minimum
0
Maximum
100
Default
100
searchstring
search

Search term to filter results. Searches across relevant text fields like names and descriptions.

Type
string
Default
""
sortBystring
sortBy

The field to sort by.

Type
string
Valid values
"name"
Default
"name"
sortDirectionstring
sortDirection

The direction to sort (ascending or descending).

Type
string
Valid values
"asc""desc"
Default
"asc"
Responses

Responses

A list of organization roles is returned.

application/json
JSON
{
  
"total": 0,
  
"items": [
  
  
{
  
  
  
"role": {
  
  
  
  
"id": "A1B2C3D4E5",
  
  
  
  
"organizationId": "A1B2C3D4E5",
  
  
  
  
"name": "string",
  
  
  
  
"description": "string",
  
  
  
  
"allTeams": true,
  
  
  
  
"breakGlass": true,
  
  
  
  
"createdAt": "string",
  
  
  
  
"createdBy": "A1B2C3D4E5",
  
  
  
  
"updatedAt": "string",
  
  
  
  
"updatedBy": "A1B2C3D4E5"
  
  
  
},
  
  
  
"memberCount": 0,
  
  
  
"permissionCount": 0
  
  
}
  
]
}
GET/org/roles/{role}

Describe an organization role

Retrieves detailed information about a specific organization role, including all assigned permissions and permission bundles.

Parameters

rolestringrequired
role*

The organization role ID.

Type
string
Required
Example"A1B2C3D4E5"
Min Length
1
Max Length
20
Pattern
"^[A-Z0-9]{1,20}$"
Responses

Responses

Organization role details retrieved successfully

application/json
JSON
{
  
"item": {
  
  
"roleId": "A1B2C3D4E5",
  
  
"permissionIds": [
  
  
  
"string"
  
  
],
  
  
"bundleIds": [
  
  
  
"string"
  
  
],
  
  
"bundlePermissions": {
  
  
  
"additionalProperties": [
  
  
  
  
"string"
  
  
  
]
  
  
}
  
},
  
"included": {
  
  
"roles": [
  
  
  
{
  
  
  
  
"role": {
  
  
  
  
  
"id": "A1B2C3D4E5",
  
  
  
  
  
"organizationId": "A1B2C3D4E5",
  
  
  
  
  
"name": "string",
  
  
  
  
  
"description": "string",
  
  
  
  
  
"allTeams": true,
  
  
  
  
  
"breakGlass": true,
  
  
  
  
  
"createdAt": "string",
  
  
  
  
  
"createdBy": "A1B2C3D4E5",
  
  
  
  
  
"updatedAt": "string",
  
  
  
  
  
"updatedBy": "A1B2C3D4E5"
  
  
  
  
},
  
  
  
  
"memberCount": 0,
  
  
  
  
"permissionCount": 0
  
  
  
}
  
  
],
  
  
"permissions": [
  
  
  
{
  
  
  
  
"relation": "CanManageUsers",
  
  
  
  
"description": "Manage user resources",
  
  
  
  
"validObjectTypes": [
  
  
  
  
  
[
  
  
  
  
  
  
"organization",
  
  
  
  
  
  
"team"
  
  
  
  
  
]
  
  
  
  
],
  
  
  
  
"systemOnly": false
  
  
  
}
  
  
],
  
  
"bundles": [
  
  
  
{
  
  
  
  
"id": "A1B2C3D4E5",
  
  
  
  
"code": "string",
  
  
  
  
"organizationId": "A1B2C3D4E5",
  
  
  
  
"name": "string",
  
  
  
  
"description": "string",
  
  
  
  
"createdAt": "string",
  
  
  
  
"createdBy": "A1B2C3D4E5",
  
  
  
  
"updatedAt": "string",
  
  
  
  
"updatedBy": "A1B2C3D4E5"
  
  
  
}
  
  
]
  
}
}
GET/org/team-roles

List team roles

Returns all team roles within the organization that can be assigned to team members.

Parameters

pageinteger
page

The page number to retrieve (1-indexed). Used with limit to support offset-based pagination.

Type
integer
Format
"int32"
Minimum
1
Default
1
limitinteger
limit

The maximum number of items to list.

Type
integer
Format
"int32"
Minimum
0
Maximum
100
Default
100
searchstring
search

Search term to filter results. Searches across relevant text fields like names and descriptions.

Type
string
Default
""
sortBystring
sortBy

The field to sort by.

Type
string
Valid values
"name"
Default
"name"
sortDirectionstring
sortDirection

The direction to sort (ascending or descending).

Type
string
Valid values
"asc""desc"
Default
"asc"
Responses

Responses

A list of team roles is returned.

application/json
JSON
{
  
"total": 0,
  
"items": [
  
  
{
  
  
  
"role": {
  
  
  
  
"id": "A1B2C3D4E5",
  
  
  
  
"organizationId": "A1B2C3D4E5",
  
  
  
  
"name": "string",
  
  
  
  
"description": "string",
  
  
  
  
"createdAt": "string",
  
  
  
  
"createdBy": "A1B2C3D4E5",
  
  
  
  
"updatedAt": "string",
  
  
  
  
"updatedBy": "A1B2C3D4E5"
  
  
  
},
  
  
  
"memberCount": 0,
  
  
  
"permissionCount": 0
  
  
}
  
]
}
GET/org/team-roles/{role}

Describe a team role

Retrieves detailed information about a specific team role, including all assigned permissions and permission bundles.

Parameters

rolestringrequired
role*

The ID of the team role.

Type
string
Required
Responses

Responses

Team role details retrieved successfully

application/json
JSON
{
  
"item": {
  
  
"roleId": "A1B2C3D4E5",
  
  
"permissionIds": [
  
  
  
"string"
  
  
],
  
  
"bundleIds": [
  
  
  
"string"
  
  
],
  
  
"bundlePermissions": {
  
  
  
"additionalProperties": [
  
  
  
  
"string"
  
  
  
]
  
  
}
  
},
  
"included": {
  
  
"roles": [
  
  
  
{
  
  
  
  
"role": {
  
  
  
  
  
"id": "A1B2C3D4E5",
  
  
  
  
  
"organizationId": "A1B2C3D4E5",
  
  
  
  
  
"name": "string",
  
  
  
  
  
"description": "string",
  
  
  
  
  
"createdAt": "string",
  
  
  
  
  
"createdBy": "A1B2C3D4E5",
  
  
  
  
  
"updatedAt": "string",
  
  
  
  
  
"updatedBy": "A1B2C3D4E5"
  
  
  
  
},
  
  
  
  
"memberCount": 0,
  
  
  
  
"permissionCount": 0
  
  
  
}
  
  
],
  
  
"permissions": [
  
  
  
{
  
  
  
  
"relation": "CanManageUsers",
  
  
  
  
"description": "Manage user resources",
  
  
  
  
"validObjectTypes": [
  
  
  
  
  
[
  
  
  
  
  
  
"organization",
  
  
  
  
  
  
"team"
  
  
  
  
  
]
  
  
  
  
],
  
  
  
  
"systemOnly": false
  
  
  
}
  
  
],
  
  
"bundles": [
  
  
  
{
  
  
  
  
"id": "A1B2C3D4E5",
  
  
  
  
"code": "string",
  
  
  
  
"organizationId": "A1B2C3D4E5",
  
  
  
  
"name": "string",
  
  
  
  
"description": "string",
  
  
  
  
"createdAt": "string",
  
  
  
  
"createdBy": "A1B2C3D4E5",
  
  
  
  
"updatedAt": "string",
  
  
  
  
"updatedBy": "A1B2C3D4E5"
  
  
  
}
  
  
]
  
}
}