Claude Platform Docs

RBAC Groups

Create RBAC Group
client.Organization.RBACGroups.New(ctx, body) (*RBACGroup, error)
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
client.Organization.RBACGroups.List(ctx, query) (*PageCursor[RBACGroup], error)
GET/v1/organizations/rbac_groups

List RBAC Groups in the Claude Enterprise tenant.

Get RBAC Group
client.Organization.RBACGroups.Get(ctx, rbacGroupID) (*RBACGroup, error)
GET/v1/organizations/rbac_groups/{rbac_group_id}

Retrieve an RBAC Group by ID.

Update RBAC Group
client.Organization.RBACGroups.Update(ctx, rbacGroupID, body) (*RBACGroup, error)
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
client.Organization.RBACGroups.Delete(ctx, rbacGroupID) (*DeletedRBACGroup, error)
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
type DeletedRBACGroup struct { Type: "rbac_group_deleted"; ID }
Type RBACGroupDeleted

Deleted object type.

For RBAC Groups, this is always "rbac_group_deleted".

defaultrbac_group_deleted
ID string

ID of the RBAC Group.

type RBACGroup struct { Type: "rbac_group"; ID; CreatedAt; /* 4 more */ }
Type RBACGroup

Object type.

For RBAC Groups, this is always "rbac_group".

defaultrbac_group
ID string

ID of the RBAC Group.

CreatedAt Time

RFC 3339 timestamp of when the RBAC Group was created.

formatdate-time
Name string

Name of the RBAC Group. Not uniqueness-enforced.

RoleIDs []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.

SourceType RBACGroupSourceType

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:
const RBACGroupSourceTypeDirect RBACGroupSourceType = "direct"
const RBACGroupSourceTypeSCIM RBACGroupSourceType = "scim"
UpdatedAt Time

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

formatdate-time
type RBACGroupGrantsOwnerAccessErrorDetails struct { ErrorCode }
ErrorCode RBACGroupGrantsOwnerAccessErrorCode
type RBACGroupOwnerAccessUnconfirmedErrorDetails struct { ErrorCode }
ErrorCode RBACGroupOwnerAccessUnconfirmedErrorCode
Errors
const ErrorCodeRBACGroupGrantsOwnerAccess ErrorCode = "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.

const ErrorCodeRBACGroupOwnerAccessUnconfirmed ErrorCode = "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.

RBAC GroupsMembers

List RBAC Group Members
client.Organization.RBACGroups.Members.List(ctx, rbacGroupID, query) (*PageCursor[RBACGroupMember], error)
GET/v1/organizations/rbac_groups/{rbac_group_id}/members

List members of an RBAC Group.

Add RBAC Group Member
client.Organization.RBACGroups.Members.Add(ctx, rbacGroupID, body) (*RBACGroupMember, error)
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
client.Organization.RBACGroups.Members.Remove(ctx, userID, body) (*DeletedRBACGroupMember, error)
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.