Claude Platform Docs

List RBAC Roles

GET/v1/organizations/rbac_roles

List RBAC Roles in the organization.

The RBAC Roles API is available to Claude Enterprise organizations only.

Query parameters
limit: optional number

Number of items to return per page.

Defaults to 20. Ranges from 1 to 1000.

default20
minimum1
maximum1000
page: optional string

Optionally set to the next_page token from the previous response.

Headers
"anthropic-version": optional string

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Returns
data: array of RBACRole { type: "rbac_role", id, created_at, 3 more }
type: "rbac_role"

Object type.

For RBAC Roles, this is always "rbac_role".

defaultrbac_role
id: string

ID of the RBAC Role.

created_at: string

RFC 3339 datetime string indicating when the RBAC Role was created.

formatdate-time
display_name: string

Name of the RBAC Role. For a built-in role, this is Anthropic's name for the access that the role grants. Anthropic may change this name, so to keep a lasting reference to a role, store its id.

Whether the RBAC Role is built-in or custom. More values of type may be added, so do not treat every role that is not built_in as custom.

One of the following:
RBACRoleSourceBuiltIn object{ type: "built_in" }
type: "built_in"

Anthropic provisions the RBAC Role, and the organization's administrators cannot change or delete it.

defaultbuilt_in
RBACRoleSourceCustom object{ type: "custom" }
type: "custom"

The organization's administrators can change and delete the RBAC Role.

defaultcustom
updated_at: string

RFC 3339 datetime string indicating when the RBAC Role was last updated.

formatdate-time
has_more: boolean

Indicates whether there are more results beyond this page.

next_page: string or null

Opaque cursor for the next page. Pass as the page parameter on the next request.

Errors

Any method can also return the general HTTP errors.

Each code below is the value of error.details.error_code in the response body.

error code organization_type_not_supportedHTTP status 400

The endpoint does not support the organization's type. Each endpoint's description says which organization types it supports.

error code parent_organization_requiredHTTP status 400

The endpoint serves only organizations that belong to a parent organization, and this organization belongs to none.

List RBAC Roles
curl https://api.anthropic.com/v1/organizations/rbac_roles \
    -H 'anthropic-version: 2026-10-21' \
    -H "Authorization: Bearer $ANTHROPIC_API_KEY"
Returns Examples
Response 200
{
  "data": [
    {
      "id": "rbac_role_016J8xVtKpDq3Wy9ZmN2hR4s",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "display_name": "Project Editor",
      "source": {
        "type": "built_in"
      },
      "type": "rbac_role",
      "updated_at": "2024-10-30T23:58:27.427722Z"
    }
  ],
  "has_more": true,
  "next_page": "eyJjdXJzb3IiOiAicmJhY19yb2xlXzAxIn0"
}