--- title: Update Agent url: https://platform.claude.com/docs/en/api/typescript/beta/agents/update --- # Update Agent `client.beta.agents.update(agentID, params, options?): BetaManagedAgentsAgent` **POST** `/v1/agents/{agent_id}` Update Agent ## Parameters - `agentID: string` (path parameter) Unique identifier of the agent to update. - `params: AgentUpdateParams` - `description?: string | null` Description. Omit to preserve; send empty string or null to clear. maxLength: 2048 - `mcp_servers?: Array | null` MCP servers. Full replacement. Omit to preserve; send empty array or `null` to clear. Names must be unique. Maximum 20. Every server must be referenced by an `mcp_toolset` in the agent's resulting `tools`; unreferenced servers are rejected. See the [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector?sdk_languages=typescript). - `type: "url"` - `name: string` Unique name for this server, referenced by mcp_toolset configurations. 1-255 characters. minLength: 1, maxLength: 255 - `url: string` Endpoint URL for the MCP server. maxLength: 2048 - `metadata?: Record | null` Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omit the field to preserve. The stored bag is limited to 16 keys (up to 64 chars each) with values up to 512 chars. - `model?: BetaManagedAgentsModel | BetaManagedAgentsModelConfigParams` Model identifier. Accepts the [model string](https://platform.claude.com/docs/en/about-claude/models/overview?sdk_languages=typescript#latest-models-comparison), e.g. `claude-opus-5`, or a `model_config` object for additional configuration control. Omit to preserve. Cannot be cleared. - `type BetaManagedAgentsModel = "claude-haiku-5-5" | "claude-sonnet-5-5" | "claude-opus-5-5" | 14 more | (string & {})` The model that will power your agent. See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options. - `"claude-haiku-5-5"` Fastest model for high-volume, real-time tasks - `"claude-sonnet-5-5"` Efficient model for coding and agents - `"claude-opus-5-5"` Powerful intelligence for coding, knowledge work, and long-running agents - `"claude-fable-5-1"` Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows - `"claude-sonnet-5"` Efficient model for coding and agents - `"claude-fable-5"` Next generation of intelligence for the hardest knowledge work and coding problems - `"claude-opus-5"` Powerful intelligence for long-running agents and coding - `"claude-opus-4-8"` Powerful intelligence for long-running agents and coding - `"claude-opus-4-7"` Powerful intelligence for long-running agents and coding - `"claude-opus-4-6"` Powerful intelligence for long-running agents and coding - `"claude-sonnet-4-6"` Best combination of speed and intelligence - `"claude-haiku-4-5"` - `"claude-haiku-4-5-20251001"` - `"claude-opus-4-5"` Powerful intelligence for long-running agents and coding - `"claude-opus-4-5-20251101"` Powerful intelligence for long-running agents and coding - `"claude-sonnet-4-5"` **Deprecated**: Will reach end-of-life on November 30, 2026. Please migrate to claude-sonnet-5-5. Visit https://docs.anthropic.com/en/docs/resources/model-deprecations for more information. High-performance model for agents and coding - `"claude-sonnet-4-5-20250929"` **Deprecated**: Will reach end-of-life on November 30, 2026. Please migrate to claude-sonnet-5-5. Visit https://docs.anthropic.com/en/docs/resources/model-deprecations for more information. High-performance model for agents and coding - `(string & {})` - `interface BetaManagedAgentsModelConfigParams` An object that defines additional configuration control over model use - `id: BetaManagedAgentsModel` The model that will power your agent. See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options. - `effort?: "low" | "medium" | "high" | 2 more | BetaManagedAgentsEffortLow | BetaManagedAgentsEffortMedium | 3 more | null` How hard Claude works on each inference call. Accepts a bare level string (`"high"`) or `{"type": "high"}`. On create, omitting it resolves the per-model default; on update, omitting it leaves the stored value unchanged. - `"low"` Low effort. Favors latency over reasoning depth. - `"medium"` Medium effort. Balances latency and reasoning depth. - `"high"` High effort. Favors reasoning depth. - `"xhigh"` Extra-high effort. Not all models accept this level. - `"max"` Maximum effort. Favors reasoning depth over latency. - `interface BetaManagedAgentsEffortLow` Low effort. Favors latency over reasoning depth. - `type: "low"` - `interface BetaManagedAgentsEffortMedium` Medium effort. Balances latency and reasoning depth. - `type: "medium"` - `interface BetaManagedAgentsEffortHigh` High effort. Favors reasoning depth. - `type: "high"` - `interface BetaManagedAgentsEffortXhigh` Extra-high effort. Not all models accept this level. - `type: "xhigh"` - `interface BetaManagedAgentsEffortMax` Maximum effort. Favors reasoning depth over latency. - `type: "max"` - `inference_geo?: string | null` Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo. On update, `model` is whole-object replacement — omitting inference_geo clears it. - `speed?: "standard" | "fast" | null` Inference speed mode. Defaults to `standard`. - `"standard"` - `"fast"` - `multiagent?: BetaManagedAgentsMultiagentParams | null` Multiagent orchestration configuration. Full replacement. Omit to preserve; send null to clear. - `interface BetaManagedAgentsMultiagentCoordinatorParams` A coordinator topology: the session's primary thread orchestrates work by spawning session threads, each running an agent drawn from the `agents` roster. - `type: "coordinator"` - `agents: Array` Agents the coordinator may spawn as session threads. 1–20 entries. Each entry is an agent ID string, a versioned `{"type":"agent","id","version"}` reference, or `{"type":"self"}` to allow recursive self-invocation. Entries must reference distinct agents (after resolving `self` and string forms); at most one `self`. Referenced agents must exist, must not be archived, and must not themselves have `multiagent` set (depth limit 1). - `string` - `interface BetaManagedAgentsAgentParams` Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version - `type: "agent"` - `id: string` The `agent` ID. minLength: 1, maxLength: 128 - `version?: number` The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified. format: int32 - `interface BetaManagedAgentsMultiagentSelfParams` Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference. - `type: "self"` - `interface BetaManagedAgentsAdvisorParams` Platform advisor roster entry: a model the session's primary thread may consult mid-turn. At most one per roster; the entry occupies the roster name `anthropic.advisor`. - `type: "advisor"` - `model: string` A Claude model id. The model must be permitted as an advisor for this agent's model. minLength: 1, maxLength: 256 - `interface BetaManagedAgentsMultiagent20261001Params` Multiagent configuration with three members, each enabled or disabled on its own. On an update, if the agent's stored `multiagent` also has type `multiagent_20261001`, this configuration is merged into the stored one, level by level, instead of replacing it. A key that the update omits keeps its stored value. A key sent as null takes its default, on create as well, so `"workflows": null` enables workflows. An object sent with a `type` other than the stored one replaces the stored object, and the keys that it omits take their defaults. A `predefined_agents` list that is sent replaces the stored list. Every object that is sent needs its `type`, and an enabled `advisor` needs its `model`. Other validation applies to the merged result. - `type: "multiagent_20261001"` - `advisor?: BetaManagedAgentsMultiagentAdvisorParams | null` Whether the session's primary thread can consult an advisor model. Defaults to disabled. - `interface BetaManagedAgentsMultiagentAdvisorEnabledParams` The session's primary thread can consult `model` mid-turn. - `type: "enabled"` - `model: string` A Claude model id. The model must be permitted as an advisor for this agent's model. minLength: 1, maxLength: 256 - `interface BetaManagedAgentsMultiagentAdvisorDisabledParams` The agent has no advisor. - `type: "disabled"` - `subagents?: BetaManagedAgentsMultiagentSubagentsParams | null` Whether the agent can spawn session threads. Defaults to enabled. - `interface BetaManagedAgentsMultiagentSubagentsEnabledParams` The agent can spawn session threads. Each thread runs a predefined agent, which is a saved agent in `predefined_agents`, or an inline agent, which the agent defines when it spawns the thread and which is not saved. If `inline_agents` is disabled, `predefined_agents` must name at least one agent. - `type: "enabled"` - `inline_agents?: BetaManagedAgentsMultiagentInlineAgentsParams | null` Whether the agent can define inline agents when it spawns session threads. Defaults to enabled. - `interface BetaManagedAgentsMultiagentInlineAgentsEnabledParams` The agent can define inline agents. - `type: "enabled"` - `interface BetaManagedAgentsMultiagentInlineAgentsDisabledParams` The agent cannot define inline agents. - `type: "disabled"` - `predefined_agents?: Array | null` Predefined agents that this agent can spawn as session threads. At most 20. Defaults to null. Null and an empty list both mean no predefined agents. This list is separate from `workflows.predefined_agents`, and an agent in one list is not added to the other. - `string` - `interface BetaManagedAgentsAgentParams` Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version - `interface BetaManagedAgentsMultiagentSelfParams` Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference. - `interface BetaManagedAgentsMultiagentSubagentsDisabledParams` The agent cannot spawn session threads. - `type: "disabled"` - `workflows?: BetaManagedAgentsMultiagentWorkflowsParams | null` Whether the agent can start workflow runs. Defaults to enabled. - `interface BetaManagedAgentsMultiagentWorkflowsEnabledParams` The agent can start workflow runs. Each run follows a plan, a program that the agent writes. A plan can use predefined agents, which are the saved agents in `predefined_agents`, and inline agents, which it defines itself and which are not saved. If `inline_agents` is disabled, `predefined_agents` must name at least one agent. - `type: "enabled"` - `inline_agents?: BetaManagedAgentsMultiagentInlineAgentsParams | null` Whether a run's plan can define inline agents. Defaults to enabled. - `predefined_agents?: Array | null` Predefined agents that a run's plan can use. At most 20. Defaults to null. Null and an empty list both mean no predefined agents. This list is separate from `subagents.predefined_agents`, and an agent in one list is not added to the other. - `string` - `interface BetaManagedAgentsAgentParams` Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version - `interface BetaManagedAgentsMultiagentSelfParams` Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference. - `interface BetaManagedAgentsMultiagentWorkflowsDisabledParams` The agent cannot start workflow runs. - `type: "disabled"` - `name?: string` Human-readable name. Must be non-empty. Omit to preserve. Cannot be cleared. maxLength: 256 - `skills?: Array | null` Skills. Full replacement. Omit to preserve; send empty array or null to clear. - `interface BetaManagedAgentsAnthropicSkillParams` An Anthropic-managed skill. - `type: "anthropic"` - `skill_id: string` Identifier of the Anthropic skill (e.g., "xlsx"). minLength: 1, maxLength: 64 - `version?: string | null` Version to pin. Defaults to latest if omitted. minLength: 1, maxLength: 64 - `interface BetaManagedAgentsCustomSkillParams` A user-created custom skill. - `type: "custom"` - `skill_id: string` Tagged ID of the custom skill (e.g., "skill_01XJ5..."). minLength: 1, maxLength: 64 - `version?: string | null` Version to pin. Defaults to latest if omitted. minLength: 1, maxLength: 64 - `system?: string | null` System prompt. Omit to preserve; send empty string or null to clear. maxLength: 100000 - `tools?: Array | null` Tool configurations available to the agent. Full replacement. Omit to preserve; send empty array or null to clear. Maximum of 256 tools across all toolsets allowed. - `interface BetaManagedAgentsAgentToolset20260401Params` Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent. - `type: "agent_toolset_20260401"` - `configs?: Array` Per-tool configuration overrides. - `interface BetaManagedAgentsBashToolConfigParams` Configuration override for the bash tool. - `type?: "bash"` - `name: "bash"` Must be "bash". - `enabled?: boolean | null` Whether this tool is enabled and available to Claude. Overrides the default_config setting. - `permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy | null` Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `type: "always_allow"` - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `type: "always_ask"` - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `type: "auto"` - `interface BetaManagedAgentsEditToolConfigParams` Configuration override for the edit tool. - `type?: "edit"` - `name: "edit"` Must be "edit". - `enabled?: boolean | null` Whether this tool is enabled and available to Claude. Overrides the default_config setting. - `permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy | null` Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `interface BetaManagedAgentsReadToolConfigParams` Configuration override for the read tool. - `type?: "read"` - `name: "read"` Must be "read". - `enabled?: boolean | null` Whether this tool is enabled and available to Claude. Overrides the default_config setting. - `permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy | null` Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `interface BetaManagedAgentsWriteToolConfigParams` Configuration override for the write tool. - `type?: "write"` - `name: "write"` Must be "write". - `enabled?: boolean | null` Whether this tool is enabled and available to Claude. Overrides the default_config setting. - `permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy | null` Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `interface BetaManagedAgentsGlobToolConfigParams` Configuration override for the glob tool. - `type?: "glob"` - `name: "glob"` Must be "glob". - `enabled?: boolean | null` Whether this tool is enabled and available to Claude. Overrides the default_config setting. - `permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy | null` Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `interface BetaManagedAgentsGrepToolConfigParams` Configuration override for the grep tool. - `type?: "grep"` - `name: "grep"` Must be "grep". - `enabled?: boolean | null` Whether this tool is enabled and available to Claude. Overrides the default_config setting. - `permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy | null` Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `interface BetaManagedAgentsWebFetchToolConfigParams` Configuration override for the web_fetch tool. - `type?: "web_fetch"` - `name: "web_fetch"` Must be "web_fetch". - `allowed_domains?: Array` Only fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains. - `blocked_domains?: Array` Never fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains. - `enabled?: boolean | null` Whether this tool is enabled and available to Claude. Overrides the default_config setting. - `max_content_tokens?: number | null` Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs. format: int32 - `permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy | null` Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `url_sources?: BetaManagedAgentsWebFetchURLSourcesParams | null` Which sources contribute URLs the tool may fetch. Omit to allow every source. - `client_tool_results?: BetaManagedAgentsWebFetchURLSourceToolFilterParams | null` Which custom tools' results contribute URLs that may be fetched: "all" (the default), "none", or an only or except list. Each name in a list must be a custom tool in the same tools array. - `type BetaManagedAgentsWebFetchURLSourceShorthand = "all" | "none"` String form of a url_sources value that has no field other than its type: "all" means {"type": "all"} and "none" means {"type": "none"}. - `"all"` - `"none"` - `type BetaManagedAgentsWebFetchURLSourceToolFilter = BetaManagedAgentsWebFetchURLSourceAll | BetaManagedAgentsWebFetchURLSourceNone | BetaManagedAgentsWebFetchURLSourceOnly | BetaManagedAgentsWebFetchURLSourceExcept` Which tools' results contribute URLs that may be fetched. - `interface BetaManagedAgentsWebFetchURLSourceAll` Every URL from this source may be fetched. This is the default. - `type: "all"` - `interface BetaManagedAgentsWebFetchURLSourceNone` This source contributes no URLs that may be fetched. - `type: "none"` - `interface BetaManagedAgentsWebFetchURLSourceOnly` Only the named tools' results contribute URLs that may be fetched. - `type: "only"` - `tools: Array` The tools whose results contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "none" to allow no tool's results. - `type: "tool_reference"` Must be "tool_reference". - `name: string` Name of the tool. Compared exactly, so upper and lower case letters are different. minLength: 1, maxLength: 128 - `interface BetaManagedAgentsWebFetchURLSourceExcept` Every tool's results contribute URLs that may be fetched, except the named tools' results. - `type: "except"` - `tools: Array` The tools whose results do not contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "all" to leave out no tool's results. - `type: "tool_reference"` Must be "tool_reference". - `name: string` Name of the tool. Compared exactly, so upper and lower case letters are different. minLength: 1, maxLength: 128 - `server_tool_results?: BetaManagedAgentsWebFetchURLSourceToolFilterParams | null` Which of the web_search and web_fetch tools' results contribute URLs that may be fetched: "all" (the default), "none", or an only or except list. Each name in a list must be "web_search" or "web_fetch". - `user_input?: BetaManagedAgentsWebFetchURLSourceUserInputParams | null` Whether URLs in the text of user messages may be fetched: "all" (the default) or "none". - `type BetaManagedAgentsWebFetchURLSourceShorthand = "all" | "none"` String form of a url_sources value that has no field other than its type: "all" means {"type": "all"} and "none" means {"type": "none"}. - `type BetaManagedAgentsWebFetchURLSourceUserInput = BetaManagedAgentsWebFetchURLSourceAll | BetaManagedAgentsWebFetchURLSourceNone` Whether URLs in the text of user messages may be fetched. - `interface BetaManagedAgentsWebFetchURLSourceAll` Every URL from this source may be fetched. This is the default. - `interface BetaManagedAgentsWebFetchURLSourceNone` This source contributes no URLs that may be fetched. - `interface BetaManagedAgentsWebSearchToolConfigParams` Configuration override for the web_search tool. - `type?: "web_search"` - `name: "web_search"` Must be "web_search". - `allowed_domains?: Array` Only return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains. - `blocked_domains?: Array` Never return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains. - `enabled?: boolean | null` Whether this tool is enabled and available to Claude. Overrides the default_config setting. - `permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy | null` Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `user_location?: BetaManagedAgentsUserLocation | null` Approximate user location for search result localization. - `type: "approximate"` Location precision. Only "approximate" is supported. - `city?: string | null` City name. minLength: 1, maxLength: 255 - `country?: string | null` Two-letter ISO 3166-1 country code, uppercase. - `region?: string | null` Region or state name. minLength: 1, maxLength: 255 - `timezone?: string | null` IANA timezone identifier, e.g. "America/Los_Angeles". minLength: 1, maxLength: 255 - `default_config?: BetaManagedAgentsAgentToolsetDefaultConfigParams | null` Default configuration applied to all tools in this set. - `enabled?: boolean | null` Whether tools are enabled and available to Claude by default. Defaults to true if not specified. - `permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy | null` Default permission policy for tools. Controls whether tool calls are auto-approved or require confirmation. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `interface BetaManagedAgentsMCPToolsetParams` Configuration for tools from an MCP server defined in `mcp_servers`. - `type: "mcp_toolset"` - `mcp_server_name: string` Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters. minLength: 1, maxLength: 255 - `configs?: Array` Per-tool configuration overrides. - `name: string` Name of the MCP tool to configure. 1-128 characters. minLength: 1, maxLength: 128 - `enabled?: boolean | null` Whether this tool is enabled. Overrides the `default_config` setting. - `permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy | null` Permission policy for this tool. Overrides the `default_config` setting. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `default_config?: BetaManagedAgentsMCPToolsetDefaultConfigParams | null` Default configuration for all tools from this server. - `enabled?: boolean | null` Whether tools are enabled by default. Defaults to true if not specified. - `permission_policy?: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy | null` Default permission policy for tools from this server. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `interface BetaManagedAgentsCustomToolParams` A custom tool that is executed by the API client rather than the agent. When the agent calls this tool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event. - `type: "custom"` - `description: string` Description of what the tool does, shown to the agent to help it decide when to use the tool. minLength: 1 - `input_schema: BetaManagedAgentsCustomToolInputSchema` JSON Schema defining the expected input parameters for the tool. - `type: "object"` - `properties?: Record | null` - `required?: Array | null` - `name: string` Unique name for the tool. 1-128 characters; letters, digits, underscores, and hyphens. minLength: 1, maxLength: 128 - `version?: number` The agent's current version, used to prevent concurrent overwrites. Obtain this value from a create or retrieve response. Must be at least 1 if specified. When supplied, the request fails if it does not match the server's current version; omit to apply the update unconditionally. format: int32 - `betas?: Array` (header parameter) Optional header to specify the beta version(s) you want to use. - `(string & {})` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"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"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"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"` - `"cache-diagnosis-2026-04-07"` - `"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"` - `"ce-user-management-2026-07-13"` - `"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"` - `workspace_id?: string` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ## Returns - `interface BetaManagedAgentsAgent` A Managed Agents `agent`. - `type: "agent"` - `id: string` - `archived_at: string | null` When the agent was archived. Null if not archived. format: date-time - `created_at: string` A timestamp in RFC 3339 format format: date-time - `description: string | null` - `mcp_servers: Array` - `type: "url"` - `name: string` - `url: string` - `metadata: Record` - `model: BetaManagedAgentsModelConfig` Model identifier and configuration. - `id: BetaManagedAgentsModel` The model that will power your agent. See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options. - `"claude-haiku-5-5"` Fastest model for high-volume, real-time tasks - `"claude-sonnet-5-5"` Efficient model for coding and agents - `"claude-opus-5-5"` Powerful intelligence for coding, knowledge work, and long-running agents - `"claude-fable-5-1"` Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows - `"claude-sonnet-5"` Efficient model for coding and agents - `"claude-fable-5"` Next generation of intelligence for the hardest knowledge work and coding problems - `"claude-opus-5"` Powerful intelligence for long-running agents and coding - `"claude-opus-4-8"` Powerful intelligence for long-running agents and coding - `"claude-opus-4-7"` Powerful intelligence for long-running agents and coding - `"claude-opus-4-6"` Powerful intelligence for long-running agents and coding - `"claude-sonnet-4-6"` Best combination of speed and intelligence - `"claude-haiku-4-5"` - `"claude-haiku-4-5-20251001"` - `"claude-opus-4-5"` Powerful intelligence for long-running agents and coding - `"claude-opus-4-5-20251101"` Powerful intelligence for long-running agents and coding - `"claude-sonnet-4-5"` **Deprecated**: Will reach end-of-life on November 30, 2026. Please migrate to claude-sonnet-5-5. Visit https://docs.anthropic.com/en/docs/resources/model-deprecations for more information. High-performance model for agents and coding - `"claude-sonnet-4-5-20250929"` **Deprecated**: Will reach end-of-life on November 30, 2026. Please migrate to claude-sonnet-5-5. Visit https://docs.anthropic.com/en/docs/resources/model-deprecations for more information. High-performance model for agents and coding - `(string & {})` - `effort?: BetaManagedAgentsEffortLow | BetaManagedAgentsEffortMedium | BetaManagedAgentsEffortHigh | 2 more` How hard Claude works on each inference call. One of `low`, `medium`, `high`, `xhigh`, `max`. Always present; resolved to the per-model default at save time when not supplied. - `interface BetaManagedAgentsEffortLow` Low effort. Favors latency over reasoning depth. - `type: "low"` - `interface BetaManagedAgentsEffortMedium` Medium effort. Balances latency and reasoning depth. - `type: "medium"` - `interface BetaManagedAgentsEffortHigh` High effort. Favors reasoning depth. - `type: "high"` - `interface BetaManagedAgentsEffortXhigh` Extra-high effort. Not all models accept this level. - `type: "xhigh"` - `interface BetaManagedAgentsEffortMax` Maximum effort. Favors reasoning depth over latency. - `type: "max"` - `inference_geo?: string` Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo. - `speed?: "standard" | "fast"` Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Defaults to `standard`. Not all models support `fast`; invalid combinations are rejected at create time. - `"standard"` - `"fast"` - `multiagent: BetaManagedAgentsMultiagent | null` Multiagent orchestration configuration. Null when the agent is single-threaded. - `interface BetaManagedAgentsMultiagentCoordinator` Resolved coordinator topology with a concrete agent roster. - `type: "coordinator"` - `agents: Array` Agents the coordinator may spawn as session threads, each resolved to a specific version. - `interface BetaManagedAgentsAgentReference` A resolved agent reference with a concrete version. - `type: "agent"` - `id: string` - `version: number` format: int32 - `interface BetaManagedAgentsAdvisor` Platform advisor roster entry: a model the session's primary thread may consult mid-turn. - `type: "advisor"` - `model: string` The advisor model id. - `interface BetaManagedAgentsMultiagent20261001` Resolved multiagent configuration with three members, each enabled or disabled on its own. - `type: "multiagent_20261001"` - `advisor: BetaManagedAgentsMultiagentAdvisor` Whether the session's primary thread can consult an advisor model. - `interface BetaManagedAgentsMultiagentAdvisorEnabled` The session's primary thread can consult `model` mid-turn. - `type: "enabled"` - `model: string` The advisor model id. - `interface BetaManagedAgentsMultiagentAdvisorDisabled` The agent has no advisor. - `type: "disabled"` - `subagents: BetaManagedAgentsMultiagentSubagents` Whether the agent can spawn session threads. - `interface BetaManagedAgentsMultiagentSubagentsEnabled` The agent can spawn session threads. - `type: "enabled"` - `inline_agents: BetaManagedAgentsMultiagentInlineAgents` Whether the agent can define inline agents, which are not saved, when it spawns session threads. - `interface BetaManagedAgentsMultiagentInlineAgentsEnabled` The agent can define inline agents. - `type: "enabled"` - `interface BetaManagedAgentsMultiagentInlineAgentsDisabled` The agent cannot define inline agents. - `type: "disabled"` - `predefined_agents: Array` Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version. - `type: "agent"` - `id: string` - `version: number` format: int32 - `interface BetaManagedAgentsMultiagentSubagentsDisabled` The agent cannot spawn session threads. - `type: "disabled"` - `workflows: BetaManagedAgentsMultiagentWorkflows` Whether the agent can start workflow runs. - `interface BetaManagedAgentsMultiagentWorkflowsEnabled` The agent can start workflow runs. - `type: "enabled"` - `inline_agents: BetaManagedAgentsMultiagentInlineAgents` Whether a run's plan can define inline agents, which are not saved. - `predefined_agents: Array` Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version. - `type: "agent"` - `id: string` - `version: number` format: int32 - `interface BetaManagedAgentsMultiagentWorkflowsDisabled` The agent cannot start workflow runs. - `type: "disabled"` - `name: string` - `skills: Array` - `interface BetaManagedAgentsAnthropicSkill` A resolved Anthropic-managed skill. - `type: "anthropic"` - `skill_id: string` - `version: string` - `interface BetaManagedAgentsCustomSkill` A resolved user-created custom skill. - `type: "custom"` - `skill_id: string` - `version: string` - `system: string | null` - `tools: Array` - `interface BetaManagedAgentsAgentToolset20260401` - `type: "agent_toolset_20260401"` - `configs: Array` - `interface BetaManagedAgentsBashToolConfig` Configuration for the bash tool. - `type: "bash"` - `enabled: boolean` - `name: "bash"` - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy` Permission policy for tool execution. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `type: "always_allow"` - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `type: "always_ask"` - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `type: "auto"` - `interface BetaManagedAgentsEditToolConfig` Configuration for the edit tool. - `type: "edit"` - `enabled: boolean` - `name: "edit"` - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy` Permission policy for tool execution. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `interface BetaManagedAgentsReadToolConfig` Configuration for the read tool. - `type: "read"` - `enabled: boolean` - `name: "read"` - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy` Permission policy for tool execution. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `interface BetaManagedAgentsWriteToolConfig` Configuration for the write tool. - `type: "write"` - `enabled: boolean` - `name: "write"` - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy` Permission policy for tool execution. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `interface BetaManagedAgentsGlobToolConfig` Configuration for the glob tool. - `type: "glob"` - `enabled: boolean` - `name: "glob"` - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy` Permission policy for tool execution. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `interface BetaManagedAgentsGrepToolConfig` Configuration for the grep tool. - `type: "grep"` - `enabled: boolean` - `name: "grep"` - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy` Permission policy for tool execution. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `interface BetaManagedAgentsWebFetchToolConfig` Configuration for the web_fetch tool. - `type: "web_fetch"` - `enabled: boolean` - `name: "web_fetch"` - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy` Permission policy for tool execution. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `url_sources: BetaManagedAgentsWebFetchURLSources | null` Which sources contribute URLs the tool may fetch, always in the object form. Null when not set, which allows every source. - `client_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter | null` Which custom tools' results contribute URLs that may be fetched. Null when not set, which allows every custom tool's results. - `interface BetaManagedAgentsWebFetchURLSourceAll` Every URL from this source may be fetched. This is the default. - `type: "all"` - `interface BetaManagedAgentsWebFetchURLSourceNone` This source contributes no URLs that may be fetched. - `type: "none"` - `interface BetaManagedAgentsWebFetchURLSourceOnly` Only the named tools' results contribute URLs that may be fetched. - `type: "only"` - `tools: Array` The tools whose results contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "none" to allow no tool's results. - `type: "tool_reference"` Must be "tool_reference". - `name: string` Name of the tool. Compared exactly, so upper and lower case letters are different. minLength: 1, maxLength: 128 - `interface BetaManagedAgentsWebFetchURLSourceExcept` Every tool's results contribute URLs that may be fetched, except the named tools' results. - `type: "except"` - `tools: Array` The tools whose results do not contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "all" to leave out no tool's results. - `type: "tool_reference"` Must be "tool_reference". - `name: string` Name of the tool. Compared exactly, so upper and lower case letters are different. minLength: 1, maxLength: 128 - `server_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter | null` Which of the web_search and web_fetch tools' results contribute URLs that may be fetched. Null when not set, which allows both. - `user_input: BetaManagedAgentsWebFetchURLSourceUserInput | null` Whether URLs in the text of user messages may be fetched. Null when not set, which allows them. - `interface BetaManagedAgentsWebFetchURLSourceAll` Every URL from this source may be fetched. This is the default. - `interface BetaManagedAgentsWebFetchURLSourceNone` This source contributes no URLs that may be fetched. - `allowed_domains?: Array` - `blocked_domains?: Array` - `max_content_tokens?: number | null` format: int32 - `interface BetaManagedAgentsWebSearchToolConfig` Configuration for the web_search tool. - `type: "web_search"` - `enabled: boolean` - `name: "web_search"` - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy` Permission policy for tool execution. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `allowed_domains?: Array` - `blocked_domains?: Array` - `user_location?: BetaManagedAgentsUserLocation | null` Approximate user location for search result localization. - `type: "approximate"` Location precision. Only "approximate" is supported. - `city?: string | null` City name. minLength: 1, maxLength: 255 - `country?: string | null` Two-letter ISO 3166-1 country code, uppercase. - `region?: string | null` Region or state name. minLength: 1, maxLength: 255 - `timezone?: string | null` IANA timezone identifier, e.g. "America/Los_Angeles". minLength: 1, maxLength: 255 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig` Resolved default configuration for agent tools. - `enabled: boolean` - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy` Permission policy for tool execution. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `interface BetaManagedAgentsMCPToolset` - `type: "mcp_toolset"` - `configs: Array` - `enabled: boolean` - `name: string` - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy` Permission policy for tool execution. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig` Resolved default configuration for all tools from an MCP server. - `enabled: boolean` - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy | BetaManagedAgentsAlwaysAskPolicy | BetaManagedAgentsAutoPolicy` Permission policy for tool execution. - `interface BetaManagedAgentsAlwaysAllowPolicy` Tool calls are automatically approved without user confirmation. - `interface BetaManagedAgentsAlwaysAskPolicy` Tool calls require user confirmation before execution. - `interface BetaManagedAgentsAutoPolicy` The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask. - `mcp_server_name: string` - `interface BetaManagedAgentsCustomTool` A custom tool as returned in API responses. - `type: "custom"` - `description: string` - `input_schema: BetaManagedAgentsCustomToolInputSchema` JSON Schema for custom tool input parameters. - `type: "object"` - `properties?: Record | null` - `required?: Array | null` - `name: string` - `updated_at: string` A timestamp in RFC 3339 format format: date-time - `version: number` The agent's current version. Starts at 1 and increments when the agent is modified. format: int32 ## Example ```typescript import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ apiKey: process.env["ANTHROPIC_API_KEY"] // This is the default and can be omitted }); const betaManagedAgentsAgent = await client.beta.agents.update( "agent_011CZkYpogX7uDKUyvBTophP", { description: "updated" } ); console.log(betaManagedAgentsAgent.id); ``` ### Response (200) ```json { "id": "agent_011CZkYpogX7uDKUyvBTophP", "archived_at": null, "created_at": "2026-03-15T10:00:00Z", "description": "A general-purpose starter agent.", "mcp_servers": [ { "name": "example-mcp", "type": "url", "url": "https://example-server.modelcontextprotocol.io/sse" } ], "metadata": { "foo": "bar" }, "model": { "id": "claude-opus-5", "effort": { "type": "low" }, "inference_geo": "inference_geo", "speed": "standard" }, "multiagent": { "advisor": { "type": "disabled" }, "subagents": { "inline_agents": { "type": "enabled" }, "predefined_agents": [ { "id": "agent_011CZkYqphY8vELVzwCUpqiQ", "type": "agent", "version": 1 } ], "type": "enabled" }, "type": "multiagent_20261001", "workflows": { "inline_agents": { "type": "enabled" }, "predefined_agents": [ { "id": "agent_011CZkYqphY8vELVzwCUpqiQ", "type": "agent", "version": 1 } ], "type": "enabled" } }, "name": "My First Agent", "skills": [ { "skill_id": "xlsx", "type": "anthropic", "version": "1" }, { "skill_id": "skill_011CZkZFNu9hAbo3jZPRgTmx", "type": "custom", "version": "2" } ], "system": "You are a general-purpose agent that can research, write code, run commands, and use connected tools to complete the user's task end to end.", "tools": [ { "configs": [ { "enabled": true, "name": "bash", "permission_policy": { "type": "always_allow" }, "type": "bash" } ], "default_config": { "enabled": true, "permission_policy": { "type": "always_ask" } }, "type": "agent_toolset_20260401" } ], "type": "agent", "updated_at": "2026-03-15T10:00:00Z", "version": 1 } ```