Update Claude Code Managed Settings Configuration
anthropic-beta: ce-claude-code-managed-settings-2026-10-06. Learn how to send beta headers.Change the organization's Claude Code managed settings mode, the RBAC Group order, or both, in one atomic write.
To change the order, send rbac_group_order with the rbac_group_order_version from the read the change is based on. If the order has changed since that read, the request returns 409: read it again and retry. To switch modes only if the order has not changed, send the current rbac_group_order and rbac_group_order_version with the new mode.
A switch to rbac_groups mode with no RBAC Group settings and no default settings copies the organization settings into a new default, in the same write, so members keep the settings they had. The copy does not follow later changes to the organization settings. If the organization settings cannot be copied, the request returns 400 and changes nothing. If they cannot be read, are over 1 MiB or are not valid, setting the default settings first avoids the copy.
After a switch to rbac_groups mode, a member in no listed RBAC Group receives the default settings, or no settings if no default is set, not the organization 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.
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/configuration \
-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 '{}'{
"mode": {
"type": "organization"
},
"mode_updated_at": "2019-12-27T18:11:19.117Z",
"rbac_group_order": [
"rbac_group_012rppKaSVsmTo6NqRDXQXNF"
],
"rbac_group_order_version": "rbac_group_order_version",
"type": "claude_code_managed_settings_configuration"
}Returns Examples
{
"mode": {
"type": "organization"
},
"mode_updated_at": "2019-12-27T18:11:19.117Z",
"rbac_group_order": [
"rbac_group_012rppKaSVsmTo6NqRDXQXNF"
],
"rbac_group_order_version": "rbac_group_order_version",
"type": "claude_code_managed_settings_configuration"
}