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

namestringRequiredExample: admin

descriptionstringRequiredExample: can manage all resources

enabledboolean · nullableOptionalDefault: true

idinteger · int32RequiredExample: 32

createdAtstring · date-timeRequired

updatedAtstring · date-timeRequired

deletedAtstring · date-time · nullableOptional

createdBystringRequiredExample: [email protected]

custombooleanRequired

effectiveEnabledbooleanRequiredDefault: true

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"
        ]
      }
    ],
    "enabled": true,
    "kubernetesPermissions": {
      "predefinedRole": "12"
    },
    "id": 32,
    "createdAt": "2026-06-10T17:23:12.426Z",
    "updatedAt": "2026-06-10T17:23:12.426Z",
    "deletedAt": "2026-06-10T17:23:12.426Z",
    "createdBy": "[email protected]",
    "custom": true,
    "effectiveEnabled": true
  }
]

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

namestringRequiredExample: admin

descriptionstringRequiredExample: can manage all resources

enabledboolean · nullableOptionalDefault: true

idinteger · int32RequiredExample: 32

createdAtstring · date-timeRequired

updatedAtstring · date-timeRequired

deletedAtstring · date-time · nullableOptional

createdBystringRequiredExample: [email protected]

custombooleanRequired

effectiveEnabledbooleanRequiredDefault: true

400

Bad request.

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

The specified resource was not found

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"
      ]
    }
  ],
  "enabled": true,
  "kubernetesPermissions": {
    "predefinedRole": "12"
  },
  "id": 32,
  "createdAt": "2026-06-10T17:23:12.426Z",
  "updatedAt": "2026-06-10T17:23:12.426Z",
  "deletedAt": "2026-06-10T17:23:12.426Z",
  "createdBy": "[email protected]",
  "custom": true,
  "effectiveEnabled": true
}