Claude Platform Docs

Mettre à jour un groupe RBAC

$ ant organization:rbac-groups update
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.

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

ID of the RBAC Group.

--name: optional string

Name of the RBAC Group. Not uniqueness-enforced.

minLength1
maxLength255
Returns
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
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 sandbox_egress_restrictedHTTP status 403

The request came from a Claude sandbox with restricted network access, which is not allowed to make this request. Send it from outside the sandbox, or from a sandbox with unrestricted network access.

Mettre à jour un groupe RBAC
ant organization:rbac-groups update \
  --rbac-group-id rbac_group_id
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"
}