Claude Platform Docs

Agents

Create Agent
client.Beta.Agents.New(ctx, params) (*BetaManagedAgentsAgent, error)
POST/v1/agents
List Agents
client.Beta.Agents.List(ctx, params) (*PageCursor[BetaManagedAgentsAgent], error)
GET/v1/agents
Get Agent
client.Beta.Agents.Get(ctx, agentID, params) (*BetaManagedAgentsAgent, error)
GET/v1/agents/{agent_id}
Update Agent
client.Beta.Agents.Update(ctx, agentID, params) (*BetaManagedAgentsAgent, error)
POST/v1/agents/{agent_id}
Archive Agent
client.Beta.Agents.Archive(ctx, agentID, body) (*BetaManagedAgentsAgent, error)
POST/v1/agents/{agent_id}/archive
Models
type BetaManagedAgentsAdvisor struct{…}

Platform advisor roster entry: a model the session's primary thread may consult mid-turn.

Model string

The advisor model id.

Type BetaManagedAgentsAdvisorType
type BetaManagedAgentsAgent struct{…}

A Managed Agents agent.

type BetaManagedAgentsAgentReference struct{…}

A resolved agent reference with a concrete version.

ID string
Type BetaManagedAgentsAgentReferenceType
Version int64
formatint32
type BetaManagedAgentsAgentToolConfigUnion interface{…}

Configuration for a specific agent tool.

One of the following:
type BetaManagedAgentsAgentToolConfigParamsUnionResp interface{…}

Configuration override for a specific tool within a toolset.

One of the following:
type BetaManagedAgentsAgentToolsetDefaultConfig struct{…}

Resolved default configuration for agent tools.

Enabled bool
PermissionPolicy BetaManagedAgentsAgentToolsetDefaultConfigPermissionPolicyUnion

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
type BetaManagedAgentsAgentToolsetDefaultConfigParamsResp struct{…}

Default configuration for all tools in a toolset.

Enabled bool Optional

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

PermissionPolicy BetaManagedAgentsAgentToolsetDefaultConfigParamsPermissionPolicyUnionResp Optional

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
type BetaManagedAgentsAgentToolset20260401 struct{…}
type BetaManagedAgentsAgentToolset20260401BashInput struct{…}

Input payload for the bash tool of the agent_toolset_20260401 toolset. All fields are optional; a normal invocation supplies command, while restart=true (with no command) reboots the runner-side bash session.

Command string Optional

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

Restart bool Optional

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

TimeoutMs int64 Optional

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

minimum0
type BetaManagedAgentsAgentToolset20260401EditInput struct{…}

Input payload for the edit tool. Performs a string replacement in the named file; by default old_string must occur exactly once.

FilePath string

Path of the file to edit.

NewString string

Replacement text.

OldString string

Substring to find and replace.

ReplaceAll bool Optional

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

type BetaManagedAgentsAgentToolset20260401GlobInput struct{…}

Input payload for the glob tool. Returns paths matching a doublestar glob pattern, newest first.

Pattern string

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

Path string Optional

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

type BetaManagedAgentsAgentToolset20260401GrepInput struct{…}

Input payload for the grep tool. Searches file contents for a regular expression, returning matching lines.

Pattern string

Regular expression to search for.

Path string Optional

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

type BetaManagedAgentsAgentToolset20260401ParamsResp struct{…}

Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.

type BetaManagedAgentsAgentToolset20260401ReadInput struct{…}

Input payload for the read tool. Reads file contents relative to the runner's working directory (or absolute when the runner permits).

FilePath string

Path of the file to read.

ViewRange []int64 Optional

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

minItems2
maxItems2
type BetaManagedAgentsAgentToolset20260401WriteInput struct{…}

Input payload for the write tool. Writes (overwriting) the entire file contents.

Content string

Full file contents to write.

FilePath string

Path of the file to write.

type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
type BetaManagedAgentsAnthropicSkill struct{…}

A resolved Anthropic-managed skill.

SkillID string
Type BetaManagedAgentsAnthropicSkillType
Version string
type BetaManagedAgentsAnthropicSkillParamsResp struct{…}

An Anthropic-managed skill.

SkillID string

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

minLength1
maxLength64
Type BetaManagedAgentsAnthropicSkillParamsType
Version string Optional

Version to pin. Defaults to latest if omitted.

minLength1
maxLength64
type BetaManagedAgentsBashToolConfig struct{…}

Configuration for the bash tool.

Enabled bool
Name Bash
PermissionPolicy BetaManagedAgentsBashToolConfigPermissionPolicyUnion

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
Type Bash
type BetaManagedAgentsBashToolConfigParamsResp struct{…}

Configuration override for the bash tool.

Name Bash

Must be "bash".

Enabled bool Optional

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

PermissionPolicy BetaManagedAgentsBashToolConfigParamsPermissionPolicyUnionResp Optional

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
Type BetaManagedAgentsBashToolConfigParamsType Optional
type BetaManagedAgentsCustomSkill struct{…}

A resolved user-created custom skill.

SkillID string
Type BetaManagedAgentsCustomSkillType
Version string
type BetaManagedAgentsCustomSkillParamsResp struct{…}

A user-created custom skill.

SkillID string

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

minLength1
maxLength64
Type BetaManagedAgentsCustomSkillParamsType
Version string Optional

Version to pin. Defaults to latest if omitted.

minLength1
maxLength64
type BetaManagedAgentsCustomTool struct{…}

A custom tool as returned in API responses.

Description string
InputSchema BetaManagedAgentsCustomToolInputSchema

JSON Schema for custom tool input parameters.

Type Object
Properties map[string, any] Optional
Required []string Optional
Name string
Type BetaManagedAgentsCustomToolType
type BetaManagedAgentsCustomToolInputSchema struct{…}

JSON Schema for custom tool input parameters.

Type Object
Properties map[string, any] Optional
Required []string Optional
type BetaManagedAgentsCustomToolParamsResp struct{…}

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.

Description string

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

minLength1
InputSchema BetaManagedAgentsCustomToolInputSchema

JSON Schema for custom tool input parameters.

Type Object
Properties map[string, any] Optional
Required []string Optional
Name string

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

minLength1
maxLength128
Type BetaManagedAgentsCustomToolParamsType
type BetaManagedAgentsEditToolConfig struct{…}

Configuration for the edit tool.

Enabled bool
Name Edit
PermissionPolicy BetaManagedAgentsEditToolConfigPermissionPolicyUnion

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
Type Edit
type BetaManagedAgentsEditToolConfigParamsResp struct{…}

Configuration override for the edit tool.

Name Edit

Must be "edit".

Enabled bool Optional

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

PermissionPolicy BetaManagedAgentsEditToolConfigParamsPermissionPolicyUnionResp Optional

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
Type BetaManagedAgentsEditToolConfigParamsType Optional
type BetaManagedAgentsEffortHigh struct{…}

High effort. Favors reasoning depth.

Type BetaManagedAgentsEffortHighType
type BetaManagedAgentsEffortLow struct{…}

Low effort. Favors latency over reasoning depth.

Type BetaManagedAgentsEffortLowType
type BetaManagedAgentsEffortMax struct{…}

Maximum effort. Favors reasoning depth over latency.

Type BetaManagedAgentsEffortMaxType
type BetaManagedAgentsEffortMedium struct{…}

Medium effort. Balances latency and reasoning depth.

Type BetaManagedAgentsEffortMediumType
type BetaManagedAgentsEffortXhigh struct{…}

Extra-high effort. Not all models accept this level.

Type BetaManagedAgentsEffortXhighType
type BetaManagedAgentsGlobToolConfig struct{…}

Configuration for the glob tool.

Enabled bool
Name Glob
PermissionPolicy BetaManagedAgentsGlobToolConfigPermissionPolicyUnion

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
Type Glob
type BetaManagedAgentsGlobToolConfigParamsResp struct{…}

Configuration override for the glob tool.

Name Glob

Must be "glob".

Enabled bool Optional

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

PermissionPolicy BetaManagedAgentsGlobToolConfigParamsPermissionPolicyUnionResp Optional

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
Type BetaManagedAgentsGlobToolConfigParamsType Optional
type BetaManagedAgentsGrepToolConfig struct{…}

Configuration for the grep tool.

Enabled bool
Name Grep
PermissionPolicy BetaManagedAgentsGrepToolConfigPermissionPolicyUnion

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
Type Grep
type BetaManagedAgentsGrepToolConfigParamsResp struct{…}

Configuration override for the grep tool.

Name Grep

Must be "grep".

Enabled bool Optional

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

PermissionPolicy BetaManagedAgentsGrepToolConfigParamsPermissionPolicyUnionResp Optional

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
Type BetaManagedAgentsGrepToolConfigParamsType Optional
type BetaManagedAgentsMCPServerURLDefinition struct{…}

URL-based MCP server connection as returned in API responses.

Name string
Type BetaManagedAgentsMCPServerURLDefinitionType
URL string
type BetaManagedAgentsMCPToolConfig struct{…}

Resolved configuration for a specific MCP tool.

Enabled bool
Name string
PermissionPolicy BetaManagedAgentsMCPToolConfigPermissionPolicyUnion

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
type BetaManagedAgentsMCPToolConfigParamsResp struct{…}

Configuration override for a specific MCP tool.

Name string

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

minLength1
maxLength128
Enabled bool Optional

Whether this tool is enabled. Overrides the default_config setting.

PermissionPolicy BetaManagedAgentsMCPToolConfigParamsPermissionPolicyUnionResp Optional

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
type BetaManagedAgentsMCPToolset struct{…}
type BetaManagedAgentsMCPToolsetDefaultConfig struct{…}

Resolved default configuration for all tools from an MCP server.

Enabled bool
PermissionPolicy BetaManagedAgentsMCPToolsetDefaultConfigPermissionPolicyUnion

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
type BetaManagedAgentsMCPToolsetDefaultConfigParamsResp struct{…}

Default configuration for all tools from an MCP server.

Enabled bool Optional

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

PermissionPolicy BetaManagedAgentsMCPToolsetDefaultConfigParamsPermissionPolicyUnionResp Optional

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
type BetaManagedAgentsMCPToolsetParamsResp struct{…}

Configuration for tools from an MCP server defined in mcp_servers.

type BetaManagedAgentsModel interface{…}

The model that will power your agent.

See models for additional details and options.

One of the following:
type BetaManagedAgentsModelConfig struct{…}

Model identifier and configuration.

type BetaManagedAgentsModelConfigParamsResp struct{…}

An object that defines additional configuration control over model use

type BetaManagedAgentsMultiagentCoordinator struct{…}

Resolved coordinator topology with a concrete agent roster.

Agents []BetaManagedAgentsMultiagentCoordinatorAgentUnion

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

One of the following:
type BetaManagedAgentsAgentReference struct{…}

A resolved agent reference with a concrete version.

ID string
Type BetaManagedAgentsAgentReferenceType
Version int64
formatint32
type BetaManagedAgentsAdvisor struct{…}

Platform advisor roster entry: a model the session's primary thread may consult mid-turn.

Model string

The advisor model id.

Type BetaManagedAgentsAdvisorType
Type BetaManagedAgentsMultiagentCoordinatorType
type BetaManagedAgentsMultiagentCoordinatorParamsResp struct{…}

A coordinator topology: the session's primary thread orchestrates work by spawning session threads, each running an agent drawn from the agents roster.

Agents []BetaManagedAgentsMultiagentRosterEntryParamsUnionResp

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:
string
type BetaManagedAgentsAgentParamsResp struct{…}

Specification for an Agent. Provide a specific version or use the short-form agent="agent_id" for the most recent version

ID string

The agent ID.

minLength1
maxLength128
Type BetaManagedAgentsAgentParamsType
Version int64 Optional

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

formatint32
type BetaManagedAgentsMultiagentSelfParamsResp struct{…}

Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.

Type BetaManagedAgentsMultiagentSelfParamsType
type BetaManagedAgentsAdvisorParamsResp struct{…}

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.

Model string

A Claude model id. The model must be permitted as an advisor for this agent's model — see the sessions/threads/advisor spec.

minLength1
maxLength256
Type BetaManagedAgentsAdvisorParamsType
Type BetaManagedAgentsMultiagentCoordinatorParamsType
type BetaManagedAgentsMultiagentSelfParamsResp struct{…}

Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.

Type BetaManagedAgentsMultiagentSelfParamsType
type BetaManagedAgentsReadToolConfig struct{…}

Configuration for the read tool.

Enabled bool
Name Read
PermissionPolicy BetaManagedAgentsReadToolConfigPermissionPolicyUnion

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
Type Read
type BetaManagedAgentsReadToolConfigParamsResp struct{…}

Configuration override for the read tool.

Name Read

Must be "read".

Enabled bool Optional

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

PermissionPolicy BetaManagedAgentsReadToolConfigParamsPermissionPolicyUnionResp Optional

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
Type BetaManagedAgentsReadToolConfigParamsType Optional
type BetaManagedAgentsSessionThreadAgent struct{…}

Resolved agent definition for a single session_thread. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from Session.agent.

type BetaManagedAgentsSkillParamsUnionResp interface{…}

Skill to load in the session container.

One of the following:
type BetaManagedAgentsAnthropicSkillParamsResp struct{…}

An Anthropic-managed skill.

SkillID string

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

minLength1
maxLength64
Type BetaManagedAgentsAnthropicSkillParamsType
Version string Optional

Version to pin. Defaults to latest if omitted.

minLength1
maxLength64
type BetaManagedAgentsCustomSkillParamsResp struct{…}

A user-created custom skill.

SkillID string

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

minLength1
maxLength64
Type BetaManagedAgentsCustomSkillParamsType
Version string Optional

Version to pin. Defaults to latest if omitted.

minLength1
maxLength64
type BetaManagedAgentsURLMCPServerParamsResp struct{…}

URL-based MCP server connection.

Name string

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

minLength1
maxLength255
Type BetaManagedAgentsURLMCPServerParamsType
URL string

Endpoint URL for the MCP server.

maxLength2048
type BetaManagedAgentsUserLocation struct{…}

Approximate user location for search result localization.

Type Approximate

Location precision. Only "approximate" is supported.

City string Optional

City name.

minLength1
maxLength255
Country string Optional

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

Region string Optional

Region or state name.

minLength1
maxLength255
Timezone string Optional

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

minLength1
maxLength255
type BetaManagedAgentsWebFetchToolConfig struct{…}

Configuration for the web_fetch tool.

Enabled bool
Name WebFetch
PermissionPolicy BetaManagedAgentsWebFetchToolConfigPermissionPolicyUnion

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
Type WebFetch
AllowedDomains []string Optional
BlockedDomains []string Optional
MaxContentTokens int64 Optional
formatint32
type BetaManagedAgentsWebFetchToolConfigParamsResp struct{…}

Configuration override for the web_fetch tool.

Name WebFetch

Must be "web_fetch".

AllowedDomains []string Optional

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.

BlockedDomains []string Optional

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 bool Optional

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

MaxContentTokens int64 Optional

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

formatint32
PermissionPolicy BetaManagedAgentsWebFetchToolConfigParamsPermissionPolicyUnionResp Optional

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
Type BetaManagedAgentsWebFetchToolConfigParamsType Optional
type BetaManagedAgentsWebSearchToolConfig struct{…}

Configuration for the web_search tool.

type BetaManagedAgentsWebSearchToolConfigParamsResp struct{…}

Configuration override for the web_search tool.

type BetaManagedAgentsWriteToolConfig struct{…}

Configuration for the write tool.

Enabled bool
Name Write
PermissionPolicy BetaManagedAgentsWriteToolConfigPermissionPolicyUnion

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
Type Write
type BetaManagedAgentsWriteToolConfigParamsResp struct{…}

Configuration override for the write tool.

Name Write

Must be "write".

Enabled bool Optional

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

PermissionPolicy BetaManagedAgentsWriteToolConfigParamsPermissionPolicyUnionResp Optional

Permission policy for tool execution.

One of the following:
type BetaManagedAgentsAlwaysAllowPolicy struct{…}

Tool calls are automatically approved without user confirmation.

Type BetaManagedAgentsAlwaysAllowPolicyType
type BetaManagedAgentsAlwaysAskPolicy struct{…}

Tool calls require user confirmation before execution.

Type BetaManagedAgentsAlwaysAskPolicyType
Type BetaManagedAgentsWriteToolConfigParamsType Optional

AgentsVersions

List Agent Versions
client.Beta.Agents.Versions.List(ctx, agentID, params) (*PageCursor[BetaManagedAgentsAgent], error)
GET/v1/agents/{agent_id}/versions