Set RBAC Group Claude Code Managed Settings
anthropic-beta: ce-claude-code-managed-settings-2026-10-06. Learn how to send beta headers.Create or replace an RBAC Group's Claude Code managed settings.
New settings join the end of rbac_group_order, and existing settings keep their place. Until the group is moved up, its members who also belong to an earlier group keep that group's settings. In organization mode a write changes no member's settings until the organization switches to rbac_groups mode. Once a group has settings, that switch no longer copies the organization settings into default settings, so members in no RBAC Group in rbac_group_order receive no settings unless you set the default settings before the switch.
Get the group's ID from the RBAC Groups API. One key can hold read:rbac_groups and write:claude_code_managed_settings.
Accepted credentials: an organization-level Admin API key with the write:claude_code_managed_settings scope.
Every request must include the beta header anthropic-beta: ce-claude-code-managed-settings-2026-10-06. A request without it, or from an organization not enabled for this beta, returns 404. The Claude Code Managed Settings API is in beta and is available to Claude Enterprise organizations only.
A write that returns 503 may have applied. Retrying it is safe.
Path parameters
Headers
Body
Returns
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.
curl https://api.anthropic.com/v1/organizations/claude_code/managed_settings/rbac_groups/$RBAC_GROUP_ID \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2026-10-21' \
-H 'anthropic-beta: ce-claude-code-managed-settings-2026-10-06' \
-H "Authorization: Bearer $ANTHROPIC_API_KEY" \
-d '{
"settings": {
"foo": "bar"
}
}'{
"created_at": "2019-12-27T18:11:19.117Z",
"rbac_group_id": "rbac_group_012rppKaSVsmTo6NqRDXQXNF",
"rbac_group_status": {
"type": "active"
},
"settings": {
"foo": "bar"
},
"type": "claude_code_rbac_group_managed_settings",
"updated_at": "2019-12-27T18:11:19.117Z"
}Returns Examples
{
"created_at": "2019-12-27T18:11:19.117Z",
"rbac_group_id": "rbac_group_012rppKaSVsmTo6NqRDXQXNF",
"rbac_group_status": {
"type": "active"
},
"settings": {
"foo": "bar"
},
"type": "claude_code_rbac_group_managed_settings",
"updated_at": "2019-12-27T18:11:19.117Z"
}