Roles

A role is a group of permissions that can be granted. Permissions are a set of actions that can be applied to entities. For more information, see Roles.

Get a list of roles.

get

Use to retrieve a list of roles.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication

Responses

200

Executed successfully.

application/json

May contain additional creation fields that are not updatable

namestringRequiredExample: admin

descriptionstringRequiredExample: can manage all resources

idinteger · int32RequiredExample: 32

createdAtstring · date-timeRequired

updatedAtstring · date-timeRequired

deletedAtstring · date-time · nullableOptional

tenantIdinteger · int32Optional

The id of the tenant.

Example: 1001

createdBystringRequiredExample: [email protected]

400

Bad request.

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

unexpected error

application/json

503

unexpected error

application/json

get

/api/v1/authorization/roles

HTTPcURLJavaScriptPython

GET /api/v1/authorization/roles HTTP/1.1
Host: app.run.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "name": "admin",
    "description": "can manage all resources",
    "permissions": [
      {
        "resourceType": "department",
        "displayName": "Projects",
        "groupId": "organization",
        "actions": [
          "create"
        ]
      }
    ],
    "id": 32,
    "createdAt": "2026-04-04T04:43:20.711Z",
    "updatedAt": "2026-04-04T04:43:20.711Z",
    "deletedAt": "2026-04-04T04:43:20.711Z",
    "tenantId": 1001,
    "createdBy": "[email protected]"
  }
]

Get a role by id.

get

Retrieve the details of a role by id.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication

Path parameters

roleIdPathinteger · int32Required

The id of the role to retrieve

Example: 32

Responses

200

Executed successfully.

application/json

May contain additional creation fields that are not updatable

namestringRequiredExample: admin

descriptionstringRequiredExample: can manage all resources

idinteger · int32RequiredExample: 32

createdAtstring · date-timeRequired

updatedAtstring · date-timeRequired

deletedAtstring · date-time · nullableOptional

tenantIdinteger · int32Optional

The id of the tenant.

Example: 1001

createdBystringRequiredExample: [email protected]

400

Bad request.

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

unexpected error

application/json

503

unexpected error

application/json

get

/api/v1/authorization/roles/{roleIdPath}

HTTPcURLJavaScriptPython

GET /api/v1/authorization/roles/{roleIdPath} HTTP/1.1
Host: app.run.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "name": "admin",
  "description": "can manage all resources",
  "permissions": [
    {
      "resourceType": "department",
      "displayName": "Projects",
      "groupId": "organization",
      "actions": [
        "create"
      ]
    }
  ],
  "id": 32,
  "createdAt": "2026-04-04T04:43:20.711Z",
  "updatedAt": "2026-04-04T04:43:20.711Z",
  "deletedAt": "2026-04-04T04:43:20.711Z",
  "tenantId": 1001,
  "createdBy": "[email protected]"
}