Claude Platform Docs

List RBAC Role Permissions

$ ant organization:rbac-roles:permissions list
GET/v1/organizations/rbac_roles/{rbac_role_id}/permissions

List the permissions an RBAC Role grants.

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

Parameters
--rbac-role-id: string⁠Path parameter

ID of the RBAC Role.

--limit: optional number⁠Query parameter

Number of items to return per page.

Defaults to 20. Ranges from 1 to 1000.

minimum1
maximum1000
--page: optional string⁠Query parameter

Optionally set to the next_page token from the previous response.

Returns
RbacRolePermissionList: object{ data, has_more, next_page }
data: array of RBACRolePermission { type: "rbac_role_permission", action, resource }
type: "rbac_role_permission"

Object type.

For RBAC Role Permissions, this is always "rbac_role_permission".

action: string

Action the permission grants on the resource.

The vocabulary follows the resource: an organization grant carries a product-feature entitlement (for example chat), an admin-panel permission entitlement (permission_*), or a blanket capability-access mode — capability_access_all grants every product-feature entitlement except inference_hooks_inspection, which a role holds only through its own row, and capability_access_all_ga grants the subset of those for stable features as it stands at permission-check time; neither mode grants model-access entitlements. A consumer enumerating a role's per-feature grants should treat a blanket row as granting every product-feature entitlement it covers, or it will under-report the role's effective access. A connector_tool grant carries a tool-access action (use or always_allow); a connector_scope grant carries the scope action grant (the role may receive the named OAuth scope when tokens are minted for the connector); connector and all_connectors grants carry a tool-access action, the scope action, or an authentication-method action (interactive or managed).

A tagged union: type names the kind of resource and determines which identifier fields are present.

One of the following:
rbac_organization_permission_resource: object{ type: "organization", organization_id }
type: "organization"

Kind of resource the permission applies to.

organization_id: string

UUID of the organization the permission applies to.

rbac_connector_tool_permission_resource: object{ type: "connector_tool", connector_id, tool_name }
type: "connector_tool"

Kind of resource the permission applies to.

connector_id: string

ID of the connector the permission applies to.

tool_name: string

Published name of the connector tool the permission applies to.

When the published name contains characters outside [a-zA-Z0-9_-] (or collides with a reserved form), it is server-encoded into a stable {prefix}_{32-hex} form — a shortened readable prefix of the name plus a hash — from which the published name is not recoverable.

rbac_connector_scope_permission_resource: object{ type: "connector_scope", connector_id, scope }
type: "connector_scope"

Kind of resource the permission applies to.

connector_id: string

ID of the connector the permission applies to.

scope: string

OAuth scope the permission names — the role may receive this scope when tokens are minted for the connector.

Subject to the same encoding rule as tool_name: a scope containing characters outside [a-zA-Z0-9_-] (or colliding with a reserved form) appears server-encoded in a stable {prefix}_{32-hex} form. OAuth scopes routinely contain : and /, so most appear encoded.

rbac_connector_permission_resource: object{ type: "connector", connector_id }
type: "connector"

Kind of resource the permission applies to.

connector_id: string

ID of the connector the permission applies to.

rbac_all_connectors_permission_resource: object{ type: "all_connectors" }
type: "all_connectors"

Kind of resource the permission applies to.

has_more: boolean

Indicates whether there are more results beyond this page.

next_page: string

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.

error code rbac_role_not_foundHTTP status 404

No RBAC Role with this ID was found.

List RBAC Role Permissions
ant organization:rbac-roles:permissions list \
  --rbac-role-id rbac_role_id
Returns Examples
Response 200
{
  "data": [
    {
      "action": "use",
      "resource": {
        "organization_id": "3c4f5e6d-7a8b-49c0-9d1e-2f3a4b5c6d7e",
        "type": "organization"
      },
      "type": "rbac_role_permission"
    }
  ],
  "has_more": true,
  "next_page": "eyJjdXJzb3IiOiAicmJhY19yb2xlXzAxIn0"
}