Claude Platform Docs

Set RBAC Group Claude Code Managed Settings

POST/v1/organizations/claude_code/managed_settings/rbac_groups/{rbac_group_id}
Requires 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
rbac_group_id: string

The RBAC Group's ID, prefixed 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.

"anthropic-beta": array of AnthropicBeta

This endpoint is in beta: requests must send ce-claude-code-managed-settings-2026-10-06 in this header.

One of the following:
string
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"output-128k-2025-02-19"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"fast-mode-2026-02-01"
"output-300k-2026-03-24"
"user-profiles-2026-03-24"
"user-profiles-2026-08-18"
"user-profiles-2026-09-04"
"advisor-tool-2026-03-01"
"managed-agents-2026-04-01"
"dreaming-2026-04-21"
"thinking-token-count-2026-05-13"
"server-side-fallback-2026-06-01"
"server-side-fallback-2026-07-01"
"fallback-credit-2026-06-01"
"fallback-credit-2026-07-01"
"agent-memory-2026-07-22"
"mid-conversation-tool-changes-2026-07-01"
"compact-2026-01-12"
"computer-use-2025-11-24"
"mcp-tunnels-2026-06-22"
"structured-outputs-2025-11-13"
"task-budgets-2026-03-13"
"thinking-display-updates-2026-08-18"
"mid-conversation-output-config-2026-07-01"
"thinking-binding-controls-2026-08-01"
"mid-conversation-system-clear-at-2026-08-21"
"compact-2026-09-04"
"inline-tools-2026-09-15"
"mcp-client-2026-09-15"
"ce-plugins-2026-09-01"
"spend-limit-reads-2026-09-26"
"telemetry-destinations-2026-08-11"
"webhooks-2026-10-07"
"admin-user-sign-out-2026-10-08"
"message-threads-2026-08-12"
"analytics-usage-cost-2026-08-24"
"experimental-claude-tag-2026-10-21"
"ce-claude-code-managed-settings-2026-10-06"
"user-profiles-billing-2026-10-01"
"message-batches-2024-09-24"⁠Deprecated
This value is no longer needed. Remove it from your requests.
"prompt-caching-2024-07-31"⁠Deprecated
This value is no longer needed. Remove it from your requests.
"pdfs-2024-09-25"⁠Deprecated
This value is no longer needed. Remove it from your requests.
"token-counting-2024-11-01"⁠Deprecated
This value is no longer needed. Remove it from your requests.
"token-efficient-tools-2025-02-19"⁠Deprecated
This value is no longer needed. Remove it from your requests.
"files-api-2025-04-14"⁠Deprecated
Sending this value selects the beta response shapes. Removing it moves you to the current shapes, so follow the migration steps: https://platform.claude.com/docs/en/build-with-claude/files#migrate-from-files-api-2025-04-14
"extended-cache-ttl-2025-04-11"⁠Deprecated
This value is no longer needed. Remove it from your requests.
"skills-2025-10-02"⁠Deprecated
Sending this value selects the beta response shapes. Removing it moves you to the current shapes, so follow the migration steps: https://platform.claude.com/docs/en/build-with-claude/skills-guide#migrate-from-skills-2025-10-02
"cache-diagnosis-2026-04-07"⁠Deprecated
This value is no longer needed. Remove it from your requests.
"ce-user-management-2026-07-13"⁠Deprecated
This value is no longer needed. Remove it from your requests.
Body
settings: map[unknown]

The whole settings document, a JSON object of Claude Code managed settings. It replaces any stored document. At most 1 MiB as the server stores it, which can be larger than the request body.

Returns
BetaClaudeCodeRBACGroupManagedSettings object{ type: "claude_code_rbac_group_managed_settings", created_at, rbac_group_id, 3 more }
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 cmek_feature_unsupportedHTTP status 400

This stored settings document currently cannot be read or replaced. Contact support, or, if you no longer need these settings, delete the group's settings or clear the default.

error code cmek_key_disabledHTTP status 400

The workspace's customer-managed encryption key is disabled or revoked. Re-enable the key, then retry.

error code rbac_group_order_limit_exceededHTTP status 400

The RBAC Group order already has the most groups allowed. Delete another group's settings first.

error code request_body_timeoutHTTP status 400

The request body did not finish arriving in time, so nothing was done. Send a smaller body, or send it over a faster connection.

error code settings_document_limit_exceededHTTP status 400

The organization has reached its limit of settings documents, counting unused ones. An owner can remove unused documents in claude.ai. Deleting a group's settings or clearing the default settings also frees a document, if nothing else uses it. None of these works once the organization has also reached its settings history limit.

error code settings_history_limit_exceededHTTP status 400

The organization has reached its settings history limit, a cap on stored versions of its settings documents. Nothing in the API or claude.ai lowers the count, so contact support. Creating or deleting group settings, creating or clearing the default settings, and reordering are refused. Changing the mode still works, unless it would copy the organization settings into a new default.

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.

error code rbac_group_not_foundHTTP status 404

The RBAC Group is not one of the organization's groups.

Set RBAC Group Claude Code Managed Settings
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"
          }
        }'
Returns Examples
Response 200
{
  "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"
}