List all roles

GET/v2/rbac/roles

Features

Send the token in the Authorization: Bearer API_TOKEN header. See Tokens for which token types this endpoint accepts.

Input0

Authorizationheaderrequired

Sent from your browser straight to the API — never to Docsbook, never stored.

Output7

datasetCapabilitiesobject

Defines the available permissions for dataset operations

descriptionstring

Detailed description of the role's purpose and scope

membersstring[]

List of user IDs that are assigned to this role

namestring

Unique name identifier for the role

orgCapabilitiesobject

Defines organization-wide permissions and capabilities

viewCapabilitiesobject

Defines the available permissions for view operations

idstring

Unique identifier for the role

Responses

200A list of roles was successfully retrieved

Example input

curl 'https://api.axiom.co/v2/rbac/roles' \
  -H 'Authorization: Bearer API_TOKEN'

Example output

[
  {
    "datasetCapabilities": {},
    "description": "string",
    "members": [
      "string"
    ],
    "name": "string",
    "orgCapabilities": {
      "annotations": [
        "create"
      ],
      "apiTokens": [
        "create"
      ],
      "auditLog": [
        "read"
      ],
      "billing": [
        "read"
      ],
      "dashboards": [
        "create"
      ],
      "datasets": [
        "create"
      ],
      "endpoints": [
        "create"
      ],
      "flows": [
        "create"
      ],
      "integrations": [
        "create"
      ],
      "monitors": [
        "create"
      ],
      "notifiers": [
        "create"
      ],
      "rbac": [
        "create"
      ]
    },
    "viewCapabilities": {},
    "id": "string"
  }
]

Updated Sep 25, 2026