ANanthropics

Update RBAC Group

Changed on

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.

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

post/v1/organizations/rbac_groups/{rbac_group_id}

Request

  • Base URL
    https://api.anthropic.com
  • Auth
    none declared

Path parameters

rbac_group_idstring required

ID of the RBAC Group.

Headers

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Request body

namestring nullable

Name of the RBAC Group. Not uniqueness-enforced.

Example request

{
  "name": "Engineering"
}

Response

Successful Response

created_atstring date-time required

RFC 3339 timestamp of when the RBAC Group was created.

idstring required

ID of the RBAC Group.

namestring required

Name of the RBAC Group. Not uniqueness-enforced.

role_idsstring[] nullable required

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' | 'scim' required

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.

type'rbac_group' required

Object type.

For RBAC Groups, this is always "rbac_group".

updated_atstring date-time required

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

Example response

{
  "created_at": "2024-10-30T23:58:27.427722Z",
  "id": "rbac_group_012rppKaSVsmTo6NqRDXQXNF",
  "name": "Engineering",
  "role_ids": [
    "rbac_role_016J8xVtKpDq3Wy9ZmN2hR4s"
  ],
  "updated_at": "2024-10-30T23:58:27.427722Z"
}

Changes