Claude Platform Docs

Agents

Create Agent
$client->beta->agents->create(Model model, string name, ?string description, ?BetaManagedAgentsExecutionIdentityParams executionIdentity, ?list<BetaManagedAgentsURLMCPServerParams> mcpServers, ?array<string,string> metadata, ?BetaManagedAgentsMultiagentParams multiagent, ?list<BetaManagedAgentsSkillParams> skills, ?string system, ?list<Tool> tools, ?list<AnthropicBeta> betas, ?string workspaceID): BetaManagedAgentsAgent
POST/v1/agents
Requires anthropic-beta: managed-agents-2026-04-01. How to send beta headers
List Agents
$client->beta->agents->list(?\Datetime createdAtGte, ?\Datetime createdAtLte, ?bool includeArchived, ?int limit, ?string page, ?list<AnthropicBeta> betas, ?string workspaceID): PageCursor<BetaManagedAgentsAgent>
GET/v1/agents
Requires anthropic-beta: managed-agents-2026-04-01. How to send beta headers
Get Agent
$client->beta->agents->retrieve(string agentID, ?int version, ?list<AnthropicBeta> betas, ?string workspaceID): BetaManagedAgentsAgent
GET/v1/agents/{agent_id}
Requires anthropic-beta: managed-agents-2026-04-01. How to send beta headers
Update Agent
$client->beta->agents->update(string agentID, ?string description, ?BetaManagedAgentsExecutionIdentityParams executionIdentity, ?list<BetaManagedAgentsURLMCPServerParams> mcpServers, ?array<string,string> metadata, ?Model model, ?BetaManagedAgentsMultiagentParams multiagent, ?string name, ?list<BetaManagedAgentsSkillParams> skills, ?string system, ?list<Tool> tools, ?int version, ?list<AnthropicBeta> betas, ?string workspaceID): BetaManagedAgentsAgent
POST/v1/agents/{agent_id}
Requires anthropic-beta: managed-agents-2026-04-01. How to send beta headers
Archive Agent
$client->beta->agents->archive(string agentID, ?list<AnthropicBeta> betas, ?string workspaceID): BetaManagedAgentsAgent
POST/v1/agents/{agent_id}/archive
Requires anthropic-beta: managed-agents-2026-04-01. How to send beta headers
Models
class BetaManagedAgentsAdvisor { $type = 'advisor'; $model; }
"advisor" type
string model

The advisor model id.

class BetaManagedAgentsAgent { $type = 'agent'; $id; $archivedAt; /* 13 more */ }
class BetaManagedAgentsAgentReference { $type = 'agent'; $id; $version; }
"agent" type
string id
int version
One of the following:
One of the following:
class BetaManagedAgentsAgentToolsetDefaultConfig { $enabled; $permissionPolicy; }
bool enabled
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsAgentToolsetDefaultConfigParams { $enabled; $permissionPolicy; }
?bool enabled

Whether tools are enabled and available to Claude by default. Defaults to true if not specified.

?PermissionPolicy permissionPolicy

Default permission policy for tools. Controls whether tool calls are auto-approved or require confirmation.

class BetaManagedAgentsAgentToolset20260401 { $type = 'agent_toolset_20260401'; $configs; $defaultConfig; }
"agent_toolset_20260401" type

Resolved default configuration for agent tools.

class BetaManagedAgentsAgentToolset20260401BashInput { $command; $restart; $timeoutMs; }
?string command

Shell command to execute. Omit only when restart is true.

?bool restart

When true, restart the persistent bash session instead of running a command. Subsequent calls without restart will run against the fresh session.

?int timeoutMs

Per-call timeout in milliseconds. Defaults to the runner-wide tool timeout when omitted or zero.

class BetaManagedAgentsAgentToolset20260401EditInput { $filePath; $newString; $oldString; $replaceAll; }
string filePath

Path of the file to edit.

string newString

Replacement text.

string oldString

Substring to find and replace.

?bool replaceAll

When true, replace every occurrence of old_string instead of requiring a unique match.

class BetaManagedAgentsAgentToolset20260401GlobInput { $pattern; $path; }
string pattern

Doublestar glob pattern (e.g. **/*.go). Absolute patterns are only permitted when the runner is configured to allow them.

?string path

Optional directory root to search under. Defaults to the runner's working directory.

class BetaManagedAgentsAgentToolset20260401GrepInput { $pattern; $path; }
string pattern

Regular expression to search for.

?string path

Optional directory root to search under. Defaults to the runner's working directory.

class BetaManagedAgentsAgentToolset20260401Params { $type = 'agent_toolset_20260401'; $configs; $defaultConfig; }
"agent_toolset_20260401" type

Per-tool configuration overrides.

Default configuration applied to all tools in this set.

class BetaManagedAgentsAgentToolset20260401ReadInput { $filePath; $viewRange; }
string filePath

Path of the file to read.

?list<int> viewRange

Optional [start_line, end_line] 1-indexed inclusive range. When omitted the entire file is returned. end_line of 0 or negative means "to end of file".

class BetaManagedAgentsAgentToolset20260401WriteInput { $content; $filePath; }
string content

Full file contents to write.

string filePath

Path of the file to write.

class BetaManagedAgentsAlwaysAllowPolicy { $type = 'always_allow'; }
"always_allow" type
class BetaManagedAgentsAlwaysAskPolicy { $type = 'always_ask'; }
"always_ask" type
class BetaManagedAgentsAnthropicSkill { $type = 'anthropic'; $skillID; $version; }
"anthropic" type
string skillID
string version
class BetaManagedAgentsAnthropicSkillParams { $type = 'anthropic'; $skillID; $version; }
"anthropic" type
string skillID

Identifier of the Anthropic skill (e.g., "xlsx").

?string version

Version to pin. Defaults to latest if omitted.

class BetaManagedAgentsAutoPolicy { $type = 'auto'; }
"auto" type
class BetaManagedAgentsAWSRoleExecutionIdentity { $type = 'aws_role'; $roleARN; }
"aws_role" type
string roleARN

The IAM role's ARN.

class BetaManagedAgentsAWSRoleExecutionIdentityParams { $type = 'aws_role'; $roleARN; }
"aws_role" type
string roleARN

The IAM role's ARN, e.g. "arn:aws:iam::123456789012:role/my-agent-runner". Maximum 2048 characters.

class BetaManagedAgentsBashToolConfig { $type = 'bash'; $enabled; $name; $permissionPolicy; }
"bash" type
bool enabled
"bash" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsBashToolConfigParams { $type; $name; $enabled; $permissionPolicy; }
?Type type
"bash" name

Must be "bash".

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.

class BetaManagedAgentsCustomSkill { $type = 'custom'; $skillID; $version; }
"custom" type
string skillID
string version
class BetaManagedAgentsCustomSkillParams { $type = 'custom'; $skillID; $version; }
"custom" type
string skillID

Tagged ID of the custom skill (e.g., "skill_01XJ5...").

?string version

Version to pin. Defaults to latest if omitted.

class BetaManagedAgentsCustomTool { $type = 'custom'; $description; $inputSchema; $name; }
"custom" type
string description

JSON Schema for custom tool input parameters.

string name
class BetaManagedAgentsCustomToolInputSchema { $type = 'object'; $properties; $required; }
"object" type
?array<string,mixed> properties
?list<string> required
class BetaManagedAgentsCustomToolParams { $type = 'custom'; $description; $inputSchema; $name; }
"custom" type
string description

Description of what the tool does, shown to the agent to help it decide when to use the tool.

JSON Schema defining the expected input parameters for the tool.

string name

Unique name for the tool. 1-128 characters; letters, digits, underscores, and hyphens.

class BetaManagedAgentsEditToolConfig { $type = 'edit'; $enabled; $name; $permissionPolicy; }
"edit" type
bool enabled
"edit" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsEditToolConfigParams { $type; $name; $enabled; $permissionPolicy; }
?Type type
"edit" name

Must be "edit".

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.

class BetaManagedAgentsEffortHigh { $type = 'high'; }
"high" type
class BetaManagedAgentsEffortLow { $type = 'low'; }
"low" type
class BetaManagedAgentsEffortMax { $type = 'max'; }
"max" type
class BetaManagedAgentsEffortMedium { $type = 'medium'; }
"medium" type
class BetaManagedAgentsEffortXhigh { $type = 'xhigh'; }
"xhigh" type
One of the following:
class BetaManagedAgentsAWSRoleExecutionIdentity { $type = 'aws_role'; $roleARN; }
"aws_role" type
string roleARN

The IAM role's ARN.

class BetaManagedAgentsServiceAccountExecutionIdentity { $type = 'service_account'; }
"service_account" type
One of the following:
class BetaManagedAgentsAWSRoleExecutionIdentityParams { $type = 'aws_role'; $roleARN; }
"aws_role" type
string roleARN

The IAM role's ARN, e.g. "arn:aws:iam::123456789012:role/my-agent-runner". Maximum 2048 characters.

class BetaManagedAgentsServiceAccountExecutionIdentityParams { $type = 'service_account'; }
"service_account" type
class BetaManagedAgentsGlobToolConfig { $type = 'glob'; $enabled; $name; $permissionPolicy; }
"glob" type
bool enabled
"glob" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsGlobToolConfigParams { $type; $name; $enabled; $permissionPolicy; }
?Type type
"glob" name

Must be "glob".

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.

class BetaManagedAgentsGrepToolConfig { $type = 'grep'; $enabled; $name; $permissionPolicy; }
"grep" type
bool enabled
"grep" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsGrepToolConfigParams { $type; $name; $enabled; $permissionPolicy; }
?Type type
"grep" name

Must be "grep".

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.

class BetaManagedAgentsMCPServerURLDefinition { $type = 'url'; $name; $url; }
"url" type
string name
string url
class BetaManagedAgentsMCPToolConfig { $enabled; $name; $permissionPolicy; }
bool enabled
string name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsMCPToolConfigParams { $name; $enabled; $permissionPolicy; }
string name

Name of the MCP tool to configure. 1-128 characters.

?bool enabled

Whether this tool is enabled. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for this tool. Overrides the default_config setting.

class BetaManagedAgentsMCPToolset { $type = 'mcp_toolset'; $configs; $defaultConfig; $mcpServerName; }
"mcp_toolset" type

Resolved default configuration for all tools from an MCP server.

string mcpServerName
class BetaManagedAgentsMCPToolsetDefaultConfig { $enabled; $permissionPolicy; }
bool enabled
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsMCPToolsetDefaultConfigParams { $enabled; $permissionPolicy; }
?bool enabled

Whether tools are enabled by default. Defaults to true if not specified.

?PermissionPolicy permissionPolicy

Default permission policy for tools from this server.

class BetaManagedAgentsMCPToolsetParams { $type = 'mcp_toolset'; $mcpServerName; $configs; $defaultConfig; }
"mcp_toolset" type
string mcpServerName

Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.

Per-tool configuration overrides.

Default configuration for all tools from this server.

One of the following:
"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

High-performance model for agents and coding

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.
"claude-sonnet-4-5-20250929"⁠Deprecated

High-performance model for agents and coding

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.
string
class BetaManagedAgentsModelConfig { $id; $effort; $inferenceGeo; $speed; }

The model that will power your agent.

See models for additional details and options.

?Effort effort

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.

?string inferenceGeo

Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.

?Speed speed

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.

class BetaManagedAgentsModelConfigParams { $id; $effort; $inferenceGeo; $speed; }

The model that will power your agent.

See models for additional details and options.

?Effort effort

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.

?string inferenceGeo

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 speed

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.

One of the following:
class BetaManagedAgentsMultiagentAdvisorEnabled { $type = 'enabled'; $model; }
"enabled" type
string model

The advisor model id.

class BetaManagedAgentsMultiagentAdvisorDisabled { $type = 'disabled'; }
"disabled" type
class BetaManagedAgentsMultiagentAdvisorDisabled { $type = 'disabled'; }
"disabled" type
class BetaManagedAgentsMultiagentAdvisorDisabledParams { $type = 'disabled'; }
"disabled" type
class BetaManagedAgentsMultiagentAdvisorEnabled { $type = 'enabled'; $model; }
"enabled" type
string model

The advisor model id.

class BetaManagedAgentsMultiagentAdvisorEnabledParams { $type = 'enabled'; $model; }
"enabled" type
string model

A Claude model id. The model must be permitted as an advisor for this agent's model.

One of the following:
class BetaManagedAgentsMultiagentAdvisorEnabledParams { $type = 'enabled'; $model; }
"enabled" type
string model

A Claude model id. The model must be permitted as an advisor for this agent's model.

class BetaManagedAgentsMultiagentAdvisorDisabledParams { $type = 'disabled'; }
"disabled" type
class BetaManagedAgentsMultiagentCoordinator { $type = 'coordinator'; $agents; }
"coordinator" type
list<Agent> agents

Agents the coordinator may spawn as session threads, each resolved to a specific version.

class BetaManagedAgentsMultiagentCoordinatorParams { $type = 'coordinator'; $agents; }
"coordinator" type

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).

One of the following:
class BetaManagedAgentsMultiagentInlineAgentsEnabled { $type = 'enabled'; }
"enabled" type
class BetaManagedAgentsMultiagentInlineAgentsDisabled { $type = 'disabled'; }
"disabled" type
class BetaManagedAgentsMultiagentInlineAgentsDisabled { $type = 'disabled'; }
"disabled" type
"disabled" type
class BetaManagedAgentsMultiagentInlineAgentsEnabled { $type = 'enabled'; }
"enabled" type
"enabled" type
One of the following:
"enabled" type
"disabled" type
One of the following:
string
class BetaManagedAgentsAgentParams { $type = 'agent'; $id; $version; }
"agent" type
string id

The agent ID.

?int version

The specific agent version to use. Omit to use the latest version. Must be at least 1 if specified.

class BetaManagedAgentsMultiagentSelfParams { $type = 'self'; }
"self" type
class BetaManagedAgentsMultiagentSelfParams { $type = 'self'; }
"self" type
One of the following:
class BetaManagedAgentsMultiagentSubagentsEnabled { $type = 'enabled'; $inlineAgents; $predefinedAgents; }
"enabled" type

Whether the agent can define inline agents, which are not saved, when it spawns session threads.

list<BetaManagedAgentsAgentReference> predefinedAgents

Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version.

class BetaManagedAgentsMultiagentSubagentsDisabled { $type = 'disabled'; }
"disabled" type
class BetaManagedAgentsMultiagentSubagentsDisabled { $type = 'disabled'; }
"disabled" type
class BetaManagedAgentsMultiagentSubagentsDisabledParams { $type = 'disabled'; }
"disabled" type
class BetaManagedAgentsMultiagentSubagentsEnabled { $type = 'enabled'; $inlineAgents; $predefinedAgents; }
"enabled" type

Whether the agent can define inline agents, which are not saved, when it spawns session threads.

list<BetaManagedAgentsAgentReference> predefinedAgents

Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version.

class BetaManagedAgentsMultiagentSubagentsEnabledParams { $type = 'enabled'; $inlineAgents; $predefinedAgents; }
"enabled" type

Whether the agent can define inline agents when it spawns session threads. Defaults to enabled.

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.

One of the following:
class BetaManagedAgentsMultiagentSubagentsEnabledParams { $type = 'enabled'; $inlineAgents; $predefinedAgents; }
"enabled" type

Whether the agent can define inline agents when it spawns session threads. Defaults to enabled.

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.

class BetaManagedAgentsMultiagentSubagentsDisabledParams { $type = 'disabled'; }
"disabled" type
One of the following:
class BetaManagedAgentsMultiagentWorkflowsEnabled { $type = 'enabled'; $inlineAgents; $predefinedAgents; }
"enabled" type

Whether a run's plan can define inline agents, which are not saved.

list<BetaManagedAgentsAgentReference> predefinedAgents

Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version.

class BetaManagedAgentsMultiagentWorkflowsDisabled { $type = 'disabled'; }
"disabled" type
class BetaManagedAgentsMultiagentWorkflowsDisabled { $type = 'disabled'; }
"disabled" type
class BetaManagedAgentsMultiagentWorkflowsDisabledParams { $type = 'disabled'; }
"disabled" type
class BetaManagedAgentsMultiagentWorkflowsEnabled { $type = 'enabled'; $inlineAgents; $predefinedAgents; }
"enabled" type

Whether a run's plan can define inline agents, which are not saved.

list<BetaManagedAgentsAgentReference> predefinedAgents

Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version.

class BetaManagedAgentsMultiagentWorkflowsEnabledParams { $type = 'enabled'; $inlineAgents; $predefinedAgents; }
"enabled" type

Whether a run's plan can define inline agents. Defaults to enabled.

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.

One of the following:
class BetaManagedAgentsMultiagentWorkflowsEnabledParams { $type = 'enabled'; $inlineAgents; $predefinedAgents; }
"enabled" type

Whether a run's plan can define inline agents. Defaults to enabled.

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.

class BetaManagedAgentsMultiagentWorkflowsDisabledParams { $type = 'disabled'; }
"disabled" type
class BetaManagedAgentsMultiagent20261001 { $type = 'multiagent_20261001'; $advisor; $subagents; $workflows; }
"multiagent_20261001" type

Whether the session's primary thread can consult an advisor model.

Whether the agent can spawn session threads.

Whether the agent can start workflow runs.

class BetaManagedAgentsMultiagent20261001Params { $type = 'multiagent_20261001'; $advisor; $subagents; $workflows; }
"multiagent_20261001" type

Whether the session's primary thread can consult an advisor model. Defaults to disabled.

Whether the agent can spawn session threads. Defaults to enabled.

Whether the agent can start workflow runs. Defaults to enabled.

class BetaManagedAgentsReadToolConfig { $type = 'read'; $enabled; $name; $permissionPolicy; }
"read" type
bool enabled
"read" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsReadToolConfigParams { $type; $name; $enabled; $permissionPolicy; }
?Type type
"read" name

Must be "read".

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.

class BetaManagedAgentsServiceAccountExecutionIdentity { $type = 'service_account'; }
"service_account" type
class BetaManagedAgentsServiceAccountExecutionIdentityParams { $type = 'service_account'; }
"service_account" type
class BetaManagedAgentsSessionThreadAgent { $type = 'agent'; $id; $description; /* 8 more */ }
"agent" type
string id
?string description

Execution principal snapshotted from the agent at session creation. Always present; {"type": "service_account"} when runs carry no customer-named principal.

Model identifier and configuration.

string name
list<Skill> skills
?string system
list<Tool> tools
int version
One of the following:
class BetaManagedAgentsAnthropicSkillParams { $type = 'anthropic'; $skillID; $version; }
"anthropic" type
string skillID

Identifier of the Anthropic skill (e.g., "xlsx").

?string version

Version to pin. Defaults to latest if omitted.

class BetaManagedAgentsCustomSkillParams { $type = 'custom'; $skillID; $version; }
"custom" type
string skillID

Tagged ID of the custom skill (e.g., "skill_01XJ5...").

?string version

Version to pin. Defaults to latest if omitted.

class BetaManagedAgentsURLMCPServerParams { $type = 'url'; $name; $url; }
"url" type
string name

Unique name for this server, referenced by mcp_toolset configurations. 1-255 characters.

string url

Endpoint URL for the MCP server.

class BetaManagedAgentsUserLocation { $type = 'approximate'; $city; $country; /* 2 more */ }
"approximate" type

Location precision. Only "approximate" is supported.

?string city

City name.

?string country

Two-letter ISO 3166-1 country code, uppercase.

?string region

Region or state name.

?string timezone

IANA timezone identifier, e.g. "America/Los_Angeles".

class BetaManagedAgentsWebFetchToolConfig { $type = 'web_fetch'; $enabled; $name; /* 5 more */ }
"web_fetch" type
bool enabled
"web_fetch" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

Which sources contribute URLs the tool may fetch, always in the object form. Null when not set, which allows every source.

?list<string> allowedDomains
?list<string> blockedDomains
?int maxContentTokens
class BetaManagedAgentsWebFetchToolConfigParams { $type; $name; $allowedDomains; /* 5 more */ }
?Type type
"web_fetch" name

Must be "web_fetch".

?list<string> allowedDomains

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.

?list<string> blockedDomains

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.

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?int maxContentTokens

Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.

?PermissionPolicy permissionPolicy

Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.

Which sources contribute URLs the tool may fetch. Omit to allow every source.

class BetaManagedAgentsWebFetchURLSourceAll { $type = 'all'; }
"all" type
class BetaManagedAgentsWebFetchURLSourceExcept { $type = 'except'; $tools; }
"except" type

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.

class BetaManagedAgentsWebFetchURLSourceNone { $type = 'none'; }
"none" type
class BetaManagedAgentsWebFetchURLSourceOnly { $type = 'only'; $tools; }
"only" type

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.

One of the following:
"all"
"none"
One of the following:
One of the following:
One of the following:
"all"
"none"
One of the following:
class BetaManagedAgentsWebFetchURLSourceToolReference { $type = 'tool_reference'; $name; }
"tool_reference" type

Must be "tool_reference".

string name

Name of the tool. Compared exactly, so upper and lower case letters are different.

One of the following:
class BetaManagedAgentsWebFetchURLSourceAll { $type = 'all'; }
"all" type
class BetaManagedAgentsWebFetchURLSourceNone { $type = 'none'; }
"none" type
One of the following:
One of the following:
"all"
"none"
One of the following:
class BetaManagedAgentsWebFetchURLSourceAll { $type = 'all'; }
"all" type
class BetaManagedAgentsWebFetchURLSourceNone { $type = 'none'; }
"none" type
class BetaManagedAgentsWebFetchURLSources { $clientToolResults; $serverToolResults; $userInput; }

Which custom tools' results contribute URLs that may be fetched. Null when not set, which allows every custom tool's results.

Which of the web_search and web_fetch tools' results contribute URLs that may be fetched. Null when not set, which allows both.

Whether URLs in the text of user messages may be fetched. Null when not set, which allows them.

class BetaManagedAgentsWebFetchURLSourcesParams { $clientToolResults; $serverToolResults; $userInput; }

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.

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".

Whether URLs in the text of user messages may be fetched: "all" (the default) or "none".

class BetaManagedAgentsWebSearchToolConfig { $type = 'web_search'; $enabled; $name; /* 4 more */ }
"web_search" type
bool enabled
"web_search" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

?list<string> allowedDomains
?list<string> blockedDomains

Approximate user location for search result localization.

class BetaManagedAgentsWebSearchToolConfigParams { $type; $name; $allowedDomains; /* 4 more */ }
?Type type
"web_search" name

Must be "web_search".

?list<string> allowedDomains

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.

?list<string> blockedDomains

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.

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.

Approximate user location for search result localization.

class BetaManagedAgentsWriteToolConfig { $type = 'write'; $enabled; $name; $permissionPolicy; }
"write" type
bool enabled
"write" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsWriteToolConfigParams { $type; $name; $enabled; $permissionPolicy; }
?Type type
"write" name

Must be "write".

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.

AgentsVersions

List Agent Versions
$client->beta->agents->versions->list(string agentID, ?int limit, ?string page, ?list<AnthropicBeta> betas, ?string workspaceID): PageCursor<BetaManagedAgentsAgent>
GET/v1/agents/{agent_id}/versions
Requires anthropic-beta: managed-agents-2026-04-01. How to send beta headers