Roles

Create Role Endpoint

post

Endpoint to create a role.

Args: role: The role to create. user: The authenticated user. rbac: RBAC component.

Raises: IllegalOperationError: If the role is an organization role. IllegalOperationError: If the role has no permissions.

Returns: The created role.

Authorizations

Body

Model for creating roles.

namestring · min: 1 · max: 50Optional

descriptionstring · min: 1 · max: 256Optional

organization_idstring · uuidRequired

levelstring · enumRequired

Scope levels.

Possible values:

system_managedbooleanRequired

typeall ofOptionalDefault: normal

string · enumOptional

Enum that represents the type of a role.

Possible values:

Responses

post

HTTPcURLJavaScriptPython

POST /roles HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 250

{
  "name": "text",
  "description": "text",
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "level": "organization",
  "system_managed": true,
  "type": "normal",
  "permissions": [
    {
      "resource": {
        "level": "organization",
        "type": "text",
        "id": "text"
      },
      "action": "text"
    }
  ]
}

{
  "name": "text",
  "description": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "level": "organization",
  "system_managed": true,
  "type": "normal"
}

Get Role Endpoint

get

Endpoint to get a role.

Args: role_id: ID of the role to get. user: The authenticated user. rbac: RBAC component.

Returns: The role.

Authorizations

Path parameters

role_idstring · uuidRequired

Responses

get

HTTPcURLJavaScriptPython

GET /roles/{role_id} HTTP/1.1
Host: 
Accept: */*

{
  "name": "text",
  "description": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "level": "organization",
  "system_managed": true,
  "type": "normal"
}

Delete Role Endpoint

delete

Endpoint to delete a role.

Args: role_id: ID of the role to delete. user: The authenticated user. rbac: RBAC component.

Raises: IllegalOperationError: If the role is system managed.

Authorizations

Path parameters

role_idstring · uuidRequired

Responses

Responseany

delete

HTTPcURLJavaScriptPython

DELETE /roles/{role_id} HTTP/1.1
Host: 
Accept: */*

No content

Update Role Endpoint

patch

Endpoint to update a role.

Args: role_id: ID of the role to update. update: The role update. user: The authenticated user. rbac: RBAC component.

Raises: IllegalOperationError: If the role has no permissions.

Returns: The updated role.

Authorizations

Path parameters

role_idstring · uuidRequired

Body

Model for updating roles.

namestring · min: 1 · max: 50Optional

descriptionstring · min: 1 · max: 256Optional

Responses

patch

HTTPcURLJavaScriptPython

PATCH /roles/{role_id} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 132

{
  "name": "text",
  "description": "text",
  "permissions": [
    {
      "resource": {
        "level": "organization",
        "type": "text",
        "id": "text"
      },
      "action": "text"
    }
  ]
}

{
  "name": "text",
  "description": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "level": "organization",
  "system_managed": true,
  "type": "normal"
}