Mettre à jour un groupe RBAC

POST/v1/organizations/rbac_groups/{rbac_group_id}

Met à jour le nom d'un groupe RBAC. Les groupes provisionnés par un fournisseur d'identité (type de source "scim") ne peuvent pas être modifiés via l'API tant qu'une organisation du locataire utilise le provisionnement SCIM.

L'API RBAC Groups est disponible uniquement pour les organisations Claude Enterprise.

Path parameters

rbac_group_id: string

ID of the RBAC Group.

Headers

"anthropic-version": optional string

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Body

name: optional string or null

Name of the RBAC Group. Not uniqueness-enforced.

minLength1

maxLength255

Returns

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

type: "rbac_group"

Object type.

For RBAC Groups, this is always "rbac_group".

defaultrbac_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 or null

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

Mettre à jour un groupe RBAC

curl https://api.anthropic.com/v1/organizations/rbac_groups/$RBAC_GROUP_ID \
    -H 'Content-Type: application/json' \
    -H 'anthropic-version: 2026-10-21' \
    -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
    -d '{
          "name": "Engineering"
        }'

Response 200

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

Returns Examples

Response 200

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