Claude Platform Docs

RBAC Groups

Create RBAC Group
$ ant organization:rbac-groups create
POST/v1/organizations/rbac_groups

Create an RBAC Group in the Claude Enterprise tenant. Groups created via the API have source type "direct".

List RBAC Groups
$ ant organization:rbac-groups list
GET/v1/organizations/rbac_groups

List RBAC Groups in the Claude Enterprise tenant.

Get RBAC Group
$ ant organization:rbac-groups retrieve
GET/v1/organizations/rbac_groups/{rbac_group_id}

Retrieve an RBAC Group by ID.

Update RBAC Group
$ ant organization:rbac-groups update
POST/v1/organizations/rbac_groups/{rbac_group_id}

Update an RBAC Group's name. Groups provisioned by an identity provider (source type "scim") cannot be modified via the API while an organization in the tenant uses SCIM provisioning.

Delete RBAC Group
$ ant organization:rbac-groups delete
DELETE/v1/organizations/rbac_groups/{rbac_group_id}

Delete an RBAC Group. Groups provisioned by an identity provider (source type "scim") cannot be deleted via the API while an organization in the tenant uses SCIM provisioning.

Models
deleted_rbac_group: object{ type: "rbac_group_deleted", id }
type: "rbac_group_deleted"

Deleted object type.

For RBAC Groups, this is always "rbac_group_deleted".

id: string

ID of the RBAC Group.

rbac_group: object{ type: "rbac_group", id, created_at, 4 more }
type: "rbac_group"

Object type.

For RBAC Groups, this is always "rbac_group".

id: string

ID of the RBAC Group.

created_at: string

RFC 3339 timestamp of when the RBAC Group was created.

formatdate-time
name: string

Name of the RBAC Group. Not uniqueness-enforced.

role_ids: array of string

RBAC Role IDs attached to this RBAC Group. Role attachment is managed in the admin settings and is read-only on this API. null means role data was temporarily unavailable — retry to distinguish from an empty list.

source_type: "direct" or "scim"

How the RBAC Group was created: "direct" for groups created directly (for example, in the organization's admin settings), "scim" for groups provisioned by the identity provider.

One of the following:
"direct"
"scim"
updated_at: string

RFC 3339 timestamp of when the RBAC Group was last updated.

formatdate-time
rbac_group_grants_owner_access_error_details: object{ error_code }
error_code: "rbac_group_grants_owner_access"
rbac_group_owner_access_unconfirmed_error_details: object{ error_code }
error_code: "rbac_group_owner_access_unconfirmed"
Errors
"rbac_group_grants_owner_access"⁠HTTP status 400

A role attached to an RBAC Group in the request grants owner access, so this API does not add members to that group (directly or through an invite), remove its members, or delete it. Make the change in the organization's admin settings in Claude.

details: object{ error_code }
error_code: "rbac_group_grants_owner_access"
"rbac_group_owner_access_unconfirmed"⁠HTTP status 400

The API could not finish checking whether an RBAC Group in the request grants owner access, so it made no change. Retrying the same request will not help. Make the change in the organization's admin settings in Claude.

details: object{ error_code }
error_code: "rbac_group_owner_access_unconfirmed"

RBAC GroupsMembers

List RBAC Group Members
$ ant organization:rbac-groups:members list
GET/v1/organizations/rbac_groups/{rbac_group_id}/members

List members of an RBAC Group.

Add RBAC Group Member
$ ant organization:rbac-groups:members add
POST/v1/organizations/rbac_groups/{rbac_group_id}/members

Add a User to an RBAC Group. Membership of groups provisioned by an identity provider (source type "scim") cannot be modified via the API while an organization in the tenant uses SCIM provisioning.

Remove RBAC Group Member
$ ant organization:rbac-groups:members remove
DELETE/v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id}

Remove a User from an RBAC Group. Membership of groups provisioned by an identity provider (source type "scim") cannot be modified via the API while an organization in the tenant uses SCIM provisioning.