List all roles

GET/v2/rbac/roles

Lists the custom roles in the organization with their capabilities and the IDs of users assigned each role directly. Built-in roles such as axiom-admin aren't included.

Request

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

Try itRun this request against your Axiom organization

Credentials stay in this browser tab and are only sent to Axiom when you run the request.

API token Required

Response

200Custom roles in the organization.

application/json

Property	Type	Description
`datasetCapabilities`	`object`	Defines the available permissions for dataset operations
`description`	`string`	Detailed description of the role's purpose and scope
`members`	`string[]`	IDs of users assigned this role directly. Returned in responses and ignored in requests. To assign a role to a user, use the Update user role endpoint.
`name`	`string`Required	Unique name identifier for the role
`orgCapabilities`	`object`	Defines organization-wide permissions and capabilities
`annotations`	`string[]`	Controls the management of annotations across the organization
`apiTokens`	`string[]`	Controls the management of API tokens for authentication
`auditLog`	`string[]`	Controls access to organization audit logs
`billing`	`string[]`	Controls access to billing information and settings
`dashboards`	`string[]`	Controls the management of organization dashboards
`datasets`	`string[]`	Controls the management of organization datasets
`endpoints`	`string[]`	Controls the management of API endpoints
`integrations`	`string[]`	Controls the management of third-party integrations
`labels`	`string[]`	Controls the management of labels
`monitors`	`string[]`	Controls the management of monitoring
`notifiers`	`string[]`	Controls the management of notification settings
`rbac`	`string[]`	Controls access to role-based access control settings
`sharedAccessKeys`	`string[]`	Controls the management of shared access keys
`users`	`string[]`	Controls user management within the organization
`views`	`string[]`	Controls the management of data views
`viewCapabilities`	`object`	Defines the available permissions for view operations
`id`	`string`Required	Unique identifier for the role