Агенты
Создать агента
BetaManagedAgentsAgent beta().agents().create(params, requestOptions = RequestOptions.none())Список агентов
AgentListPage beta().agents().list(params = AgentListParams.none(), requestOptions = RequestOptions.none())Получить агента
BetaManagedAgentsAgent beta().agents().retrieve(params = AgentRetrieveParams.none(), requestOptions = RequestOptions.none())Обновить агента
BetaManagedAgentsAgent beta().agents().update(params = AgentUpdateParams.none(), requestOptions = RequestOptions.none())Архивировать агента
BetaManagedAgentsAgent beta().agents().archive(params = AgentArchiveParams.none(), requestOptions = RequestOptions.none())Models
class BetaManagedAgentsAdvisor { type; model; }Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
The advisor model id.
class BetaManagedAgentsAgent { type; id; archivedAt; /* 13 more */ }A Managed Agents agent.
A Managed Agents agent.
class BetaManagedAgentsAgentReference { type; id; version; }A resolved agent reference with a concrete version.
A resolved agent reference with a concrete version.
long version
class BetaManagedAgentsAgentToolConfig: unionConfiguration for a specific agent tool.
Configuration for a specific agent tool.
class BetaManagedAgentsAgentToolConfigParams: unionConfiguration override for a specific tool within a toolset.
Configuration override for a specific tool within a toolset.
class BetaManagedAgentsAgentToolsetDefaultConfig { enabled; permissionPolicy; }Resolved default configuration for agent tools.
Resolved default configuration for agent tools.
PermissionPolicy permissionPolicyPermission policy for tool execution.
Permission policy for tool execution.
class BetaManagedAgentsAlwaysAllowPolicy { type; }Tool calls are automatically approved without user confirmation.
Tool calls are automatically approved without user confirmation.
class BetaManagedAgentsAlwaysAskPolicy { type; }Tool calls require user confirmation before execution.
Tool calls require user confirmation before execution.
class BetaManagedAgentsAutoPolicy { type = "auto"; }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.
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.
class BetaManagedAgentsAgentToolsetDefaultConfigParams { enabled; permissionPolicy; }Default configuration for all tools in a toolset.
Default configuration for all tools in a toolset.
Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
Optional<PermissionPolicy> permissionPolicyDefault permission policy for tools. Controls whether tool calls are auto-approved or require confirmation.
Default permission policy for tools. Controls whether tool calls are auto-approved or require confirmation.
class BetaManagedAgentsAlwaysAllowPolicy { type; }Tool calls are automatically approved without user confirmation.
Tool calls are automatically approved without user confirmation.
class BetaManagedAgentsAlwaysAskPolicy { type; }Tool calls require user confirmation before execution.
Tool calls require user confirmation before execution.
class BetaManagedAgentsAutoPolicy { type = "auto"; }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.
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.
class BetaManagedAgentsAgentToolset20260401 { type; configs; defaultConfig; }
class BetaManagedAgentsAgentToolset20260401BashInput { command; restart; timeoutMs; }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.
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.
Shell command to execute. Omit only when restart is true.
When true, restart the persistent bash session instead of
running a command. Subsequent calls without restart will
run against the fresh session.
Optional<Long> timeoutMsPer-call timeout in milliseconds. Defaults to the
runner-wide tool timeout when omitted or zero.
Per-call timeout in milliseconds. Defaults to the runner-wide tool timeout when omitted or zero.
class BetaManagedAgentsAgentToolset20260401EditInput { filePath; newString; oldString; replaceAll; }Input payload for the edit tool. Performs a string
replacement in the named file; by default old_string must
occur exactly once.
Input payload for the edit tool. Performs a string
replacement in the named file; by default old_string must
occur exactly once.
Path of the file to edit.
Replacement text.
Substring to find and replace.
When true, replace every occurrence of old_string
instead of requiring a unique match.
class BetaManagedAgentsAgentToolset20260401GlobInput { pattern; path; }Input payload for the glob tool. Returns paths matching a
doublestar glob pattern, newest first.
Input payload for the glob tool. Returns paths matching a
doublestar glob pattern, newest first.
Doublestar glob pattern (e.g. **/*.go). Absolute patterns
are only permitted when the runner is configured to allow
them.
Optional directory root to search under. Defaults to the runner's working directory.
class BetaManagedAgentsAgentToolset20260401GrepInput { pattern; path; }Input payload for the grep tool. Searches file contents for
a regular expression, returning matching lines.
Input payload for the grep tool. Searches file contents for
a regular expression, returning matching lines.
Regular expression to search for.
Optional directory root to search under. Defaults to the runner's working directory.
class BetaManagedAgentsAgentToolset20260401Params { type; configs; defaultConfig; }Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.
Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.
class BetaManagedAgentsAgentToolset20260401ReadInput { filePath; viewRange; }Input payload for the read tool. Reads file contents
relative to the runner's working directory (or absolute when
the runner permits).
Input payload for the read tool. Reads file contents
relative to the runner's working directory (or absolute when
the runner permits).
Path of the file to read.
Optional<List<Long>> viewRangeOptional [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".
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; }Input payload for the write tool. Writes (overwriting) the
entire file contents.
Input payload for the write tool. Writes (overwriting) the
entire file contents.
Full file contents to write.
Path of the file to write.
class BetaManagedAgentsAlwaysAllowPolicy { type; }Tool calls are automatically approved without user confirmation.
Tool calls are automatically approved without user confirmation.
class BetaManagedAgentsAlwaysAskPolicy { type; }Tool calls require user confirmation before execution.
Tool calls require user confirmation before execution.
class BetaManagedAgentsAnthropicSkill { type; skillId; version; }A resolved Anthropic-managed skill.
A resolved Anthropic-managed skill.
class BetaManagedAgentsAnthropicSkillParams { type; skillId; version; }An Anthropic-managed skill.
An Anthropic-managed skill.
String skillIdIdentifier of the Anthropic skill (e.g., "xlsx").
Identifier of the Anthropic skill (e.g., "xlsx").
Optional<String> versionVersion to pin. Defaults to latest if omitted.
Version to pin. Defaults to latest if omitted.
class BetaManagedAgentsAutoPolicy { type = "auto"; }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.
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.
class BetaManagedAgentsAwsRoleExecutionIdentity { type = "aws_role"; roleArn; }An AWS IAM role principal as returned in API responses.
An AWS IAM role principal as returned in API responses.
The IAM role's ARN.
class BetaManagedAgentsAwsRoleExecutionIdentityParams { type = "aws_role"; roleArn; }An AWS IAM role principal.
An AWS IAM role principal.
String roleArnThe IAM role's ARN, e.g. "arn:aws:iam::123456789012:role/my-agent-runner". Maximum 2048 characters.
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; }Configuration for the bash tool.
Configuration for the bash tool.
PermissionPolicy permissionPolicyPermission policy for tool execution.
Permission policy for tool execution.
class BetaManagedAgentsAlwaysAllowPolicy { type; }Tool calls are automatically approved without user confirmation.
Tool calls are automatically approved without user confirmation.
class BetaManagedAgentsAlwaysAskPolicy { type; }Tool calls require user confirmation before execution.
Tool calls require user confirmation before execution.
class BetaManagedAgentsAutoPolicy { type = "auto"; }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.
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.
class BetaManagedAgentsBashToolConfigParams { type; name; enabled; permissionPolicy; }Configuration override for the bash tool.
Configuration override for the bash tool.
class BetaManagedAgentsCustomSkill { type; skillId; version; }A resolved user-created custom skill.
A resolved user-created custom skill.
class BetaManagedAgentsCustomSkillParams { type; skillId; version; }A user-created custom skill.
A user-created custom skill.
String skillIdTagged ID of the custom skill (e.g., "skill_01XJ5...").
Tagged ID of the custom skill (e.g., "skill_01XJ5...").
Optional<String> versionVersion to pin. Defaults to latest if omitted.
Version to pin. Defaults to latest if omitted.
class BetaManagedAgentsCustomTool { type; description; inputSchema; name; }A custom tool as returned in API responses.
A custom tool as returned in API responses.
BetaManagedAgentsCustomToolInputSchema inputSchemaJSON Schema for custom tool input parameters.
JSON Schema for custom tool input parameters.
class BetaManagedAgentsCustomToolInputSchema { type = "object"; properties; required; }JSON Schema for custom tool input parameters.
JSON Schema for custom tool input parameters.
class BetaManagedAgentsCustomToolParams { type; description; inputSchema; name; }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.
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.
String descriptionDescription of what the tool does, shown to the agent to help it decide when to use the tool.
Description of what the tool does, shown to the agent to help it decide when to use the tool.
BetaManagedAgentsCustomToolInputSchema inputSchemaJSON Schema defining the expected input parameters for the tool.
JSON Schema defining the expected input parameters for the tool.
String nameUnique name for the tool. 1-128 characters; letters, digits, underscores, and hyphens.
Unique name for the tool. 1-128 characters; letters, digits, underscores, and hyphens.
class BetaManagedAgentsEditToolConfig { type = "edit"; enabled; name; permissionPolicy; }Configuration for the edit tool.
Configuration for the edit tool.
PermissionPolicy permissionPolicyPermission policy for tool execution.
Permission policy for tool execution.
class BetaManagedAgentsAlwaysAllowPolicy { type; }Tool calls are automatically approved without user confirmation.
Tool calls are automatically approved without user confirmation.
class BetaManagedAgentsAlwaysAskPolicy { type; }Tool calls require user confirmation before execution.
Tool calls require user confirmation before execution.
class BetaManagedAgentsAutoPolicy { type = "auto"; }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.
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.
class BetaManagedAgentsEditToolConfigParams { type; name; enabled; permissionPolicy; }Configuration override for the edit tool.
Configuration override for the edit tool.
class BetaManagedAgentsEffortHigh { type; }High effort. Favors reasoning depth.
High effort. Favors reasoning depth.
class BetaManagedAgentsEffortLow { type; }Low effort. Favors latency over reasoning depth.
Low effort. Favors latency over reasoning depth.
class BetaManagedAgentsEffortMax { type; }Maximum effort. Favors reasoning depth over latency.
Maximum effort. Favors reasoning depth over latency.
class BetaManagedAgentsEffortMedium { type; }Medium effort. Balances latency and reasoning depth.
Medium effort. Balances latency and reasoning depth.
class BetaManagedAgentsEffortXhigh { type; }Extra-high effort. Not all models accept this level.
Extra-high effort. Not all models accept this level.
class BetaManagedAgentsExecutionIdentity: unionExecution principal for runs of this agent as returned in API responses.
Execution principal for runs of this agent as returned in API responses.
class BetaManagedAgentsAwsRoleExecutionIdentity { type = "aws_role"; roleArn; }An AWS IAM role principal as returned in API responses.
An AWS IAM role principal as returned in API responses.
The IAM role's ARN.
class BetaManagedAgentsServiceAccountExecutionIdentity { type = "service_account"; }The Anthropic-managed service account as returned in API responses.
The Anthropic-managed service account as returned in API responses.
class BetaManagedAgentsExecutionIdentityParams: unionExecution principal for runs of this agent: service_account (the default) or aws_role.
Execution principal for runs of this agent: service_account (the default) or aws_role.
class BetaManagedAgentsAwsRoleExecutionIdentityParams { type = "aws_role"; roleArn; }An AWS IAM role principal.
An AWS IAM role principal.
String roleArnThe IAM role's ARN, e.g. "arn:aws:iam::123456789012:role/my-agent-runner". Maximum 2048 characters.
The IAM role's ARN, e.g. "arn:aws:iam::123456789012:role/my-agent-runner". Maximum 2048 characters.
class BetaManagedAgentsServiceAccountExecutionIdentityParams { type = "service_account"; }The Anthropic-managed service account — the default execution principal. Carries no identifier.
The Anthropic-managed service account — the default execution principal. Carries no identifier.
class BetaManagedAgentsGlobToolConfig { type = "glob"; enabled; name; permissionPolicy; }Configuration for the glob tool.
Configuration for the glob tool.
PermissionPolicy permissionPolicyPermission policy for tool execution.
Permission policy for tool execution.
class BetaManagedAgentsAlwaysAllowPolicy { type; }Tool calls are automatically approved without user confirmation.
Tool calls are automatically approved without user confirmation.
class BetaManagedAgentsAlwaysAskPolicy { type; }Tool calls require user confirmation before execution.
Tool calls require user confirmation before execution.
class BetaManagedAgentsAutoPolicy { type = "auto"; }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.
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.
class BetaManagedAgentsGlobToolConfigParams { type; name; enabled; permissionPolicy; }Configuration override for the glob tool.
Configuration override for the glob tool.
class BetaManagedAgentsGrepToolConfig { type = "grep"; enabled; name; permissionPolicy; }Configuration for the grep tool.
Configuration for the grep tool.
PermissionPolicy permissionPolicyPermission policy for tool execution.
Permission policy for tool execution.
class BetaManagedAgentsAlwaysAllowPolicy { type; }Tool calls are automatically approved without user confirmation.
Tool calls are automatically approved without user confirmation.
class BetaManagedAgentsAlwaysAskPolicy { type; }Tool calls require user confirmation before execution.
Tool calls require user confirmation before execution.
class BetaManagedAgentsAutoPolicy { type = "auto"; }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.
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.
class BetaManagedAgentsGrepToolConfigParams { type; name; enabled; permissionPolicy; }Configuration override for the grep tool.
Configuration override for the grep tool.
class BetaManagedAgentsMcpServerUrlDefinition { type; name; url; }URL-based MCP server connection as returned in API responses.
URL-based MCP server connection as returned in API responses.
class BetaManagedAgentsMcpToolConfig { enabled; name; permissionPolicy; }Resolved configuration for a specific MCP tool.
Resolved configuration for a specific MCP tool.
PermissionPolicy permissionPolicyPermission policy for tool execution.
Permission policy for tool execution.
class BetaManagedAgentsAlwaysAllowPolicy { type; }Tool calls are automatically approved without user confirmation.
Tool calls are automatically approved without user confirmation.
class BetaManagedAgentsAlwaysAskPolicy { type; }Tool calls require user confirmation before execution.
Tool calls require user confirmation before execution.
class BetaManagedAgentsAutoPolicy { type = "auto"; }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.
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.
class BetaManagedAgentsMcpToolConfigParams { name; enabled; permissionPolicy; }Configuration override for a specific MCP tool.
Configuration override for a specific MCP tool.
String nameName of the MCP tool to configure. 1-128 characters.
Name of the MCP tool to configure. 1-128 characters.
Whether this tool is enabled. Overrides the default_config setting.
Optional<PermissionPolicy> permissionPolicyPermission policy for this tool. Overrides the default_config setting.
Permission policy for this tool. Overrides the default_config setting.
class BetaManagedAgentsAlwaysAllowPolicy { type; }Tool calls are automatically approved without user confirmation.
Tool calls are automatically approved without user confirmation.
class BetaManagedAgentsAlwaysAskPolicy { type; }Tool calls require user confirmation before execution.
Tool calls require user confirmation before execution.
class BetaManagedAgentsAutoPolicy { type = "auto"; }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.
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.
class BetaManagedAgentsMcpToolset { type; configs; defaultConfig; mcpServerName; }
class BetaManagedAgentsMcpToolsetDefaultConfig { enabled; permissionPolicy; }Resolved default configuration for all tools from an MCP server.
Resolved default configuration for all tools from an MCP server.
PermissionPolicy permissionPolicyPermission policy for tool execution.
Permission policy for tool execution.
class BetaManagedAgentsAlwaysAllowPolicy { type; }Tool calls are automatically approved without user confirmation.
Tool calls are automatically approved without user confirmation.
class BetaManagedAgentsAlwaysAskPolicy { type; }Tool calls require user confirmation before execution.
Tool calls require user confirmation before execution.
class BetaManagedAgentsAutoPolicy { type = "auto"; }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.
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.
class BetaManagedAgentsMcpToolsetDefaultConfigParams { enabled; permissionPolicy; }Default configuration for all tools from an MCP server.
Default configuration for all tools from an MCP server.
Whether tools are enabled by default. Defaults to true if not specified.
Optional<PermissionPolicy> permissionPolicyDefault permission policy for tools from this server.
Default permission policy for tools from this server.
class BetaManagedAgentsAlwaysAllowPolicy { type; }Tool calls are automatically approved without user confirmation.
Tool calls are automatically approved without user confirmation.
class BetaManagedAgentsAlwaysAskPolicy { type; }Tool calls require user confirmation before execution.
Tool calls require user confirmation before execution.
class BetaManagedAgentsAutoPolicy { type = "auto"; }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.
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.
class BetaManagedAgentsMcpToolsetParams { type; mcpServerName; configs; defaultConfig; }Configuration for tools from an MCP server defined in mcp_servers.
Configuration for tools from an MCP server defined in mcp_servers.
enum BetaManagedAgentsModelThe model that will power your agent.
The model that will power your agent.
See models for additional details and options.
class BetaManagedAgentsModelConfig { id; effort; inferenceGeo; speed; }Model identifier and configuration.
Model identifier and configuration.
class BetaManagedAgentsModelConfigParams { id; effort; inferenceGeo; speed; }An object that defines additional configuration control over model use
An object that defines additional configuration control over model use
class BetaManagedAgentsMultiagentAdvisor: unionWhether the session's primary thread can consult an advisor model.
Whether the session's primary thread can consult an advisor model.
class BetaManagedAgentsMultiagentAdvisorEnabled { type = "enabled"; model; }The session's primary thread can consult model mid-turn.
The session's primary thread can consult model mid-turn.
The advisor model id.
class BetaManagedAgentsMultiagentAdvisorDisabled { type = "disabled"; }The agent has no advisor.
The agent has no advisor.
class BetaManagedAgentsMultiagentAdvisorDisabled { type = "disabled"; }The agent has no advisor.
The agent has no advisor.
class BetaManagedAgentsMultiagentAdvisorDisabledParams { type = "disabled"; }The agent has no advisor.
The agent has no advisor.
class BetaManagedAgentsMultiagentAdvisorEnabled { type = "enabled"; model; }The session's primary thread can consult model mid-turn.
The session's primary thread can consult model mid-turn.
The advisor model id.
class BetaManagedAgentsMultiagentAdvisorEnabledParams { type = "enabled"; model; }The session's primary thread can consult model mid-turn.
The session's primary thread can consult model mid-turn.
String modelA Claude model id. The model must be permitted as an advisor for this agent's model.
A Claude model id. The model must be permitted as an advisor for this agent's model.
class BetaManagedAgentsMultiagentAdvisorParams: unionWhether the session's primary thread can consult an advisor model.
Whether the session's primary thread can consult an advisor model.
class BetaManagedAgentsMultiagentAdvisorEnabledParams { type = "enabled"; model; }The session's primary thread can consult model mid-turn.
The session's primary thread can consult model mid-turn.
String modelA Claude model id. The model must be permitted as an advisor for this agent's model.
A Claude model id. The model must be permitted as an advisor for this agent's model.
class BetaManagedAgentsMultiagentAdvisorDisabledParams { type = "disabled"; }The agent has no advisor.
The agent has no advisor.
class BetaManagedAgentsMultiagentCoordinator { type; agents; }Resolved coordinator topology with a concrete agent roster.
Resolved coordinator topology with a concrete agent roster.
List<Agent> agentsAgents the coordinator may spawn as session threads, each resolved to a specific version.
Agents the coordinator may spawn as session threads, each resolved to a specific version.
class BetaManagedAgentsAgentReference { type; id; version; }A resolved agent reference with a concrete version.
A resolved agent reference with a concrete version.
long version
class BetaManagedAgentsAdvisor { type; model; }Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
The advisor model id.
class BetaManagedAgentsMultiagentCoordinatorParams { type; agents; }A coordinator topology: the session's primary thread orchestrates work by spawning session threads, each running an agent drawn from the agents roster.
A coordinator topology: the session's primary thread orchestrates work by spawning session threads, each running an agent drawn from the agents roster.
class BetaManagedAgentsMultiagentInlineAgents: unionWhether the agent can define inline agents. The agent defines an inline agent itself, in a workflow run's plan or when it spawns a session thread, and the inline agent is not saved.
Whether the agent can define inline agents. The agent defines an inline agent itself, in a workflow run's plan or when it spawns a session thread, and the inline agent is not saved.
class BetaManagedAgentsMultiagentInlineAgentsEnabled { type = "enabled"; }The agent can define inline agents.
The agent can define inline agents.
class BetaManagedAgentsMultiagentInlineAgentsDisabled { type = "disabled"; }The agent cannot define inline agents.
The agent cannot define inline agents.
class BetaManagedAgentsMultiagentInlineAgentsDisabled { type = "disabled"; }The agent cannot define inline agents.
The agent cannot define inline agents.
class BetaManagedAgentsMultiagentInlineAgentsDisabledParams { type = "disabled"; }The agent cannot define inline agents.
The agent cannot define inline agents.
class BetaManagedAgentsMultiagentInlineAgentsEnabled { type = "enabled"; }The agent can define inline agents.
The agent can define inline agents.
class BetaManagedAgentsMultiagentInlineAgentsEnabledParams { type = "enabled"; }The agent can define inline agents.
The agent can define inline agents.
class BetaManagedAgentsMultiagentInlineAgentsParams: unionWhether the agent can define inline agents. The agent defines an inline agent itself, in a workflow run's plan or when it spawns a session thread, and the inline agent is not saved.
Whether the agent can define inline agents. The agent defines an inline agent itself, in a workflow run's plan or when it spawns a session thread, and the inline agent is not saved.
class BetaManagedAgentsMultiagentInlineAgentsEnabledParams { type = "enabled"; }The agent can define inline agents.
The agent can define inline agents.
class BetaManagedAgentsMultiagentInlineAgentsDisabledParams { type = "disabled"; }The agent cannot define inline agents.
The agent cannot define inline agents.
class BetaManagedAgentsMultiagentPredefinedAgentParams: unionOne agent in a predefined_agents list. It is an agent ID string, an agent reference with an optional version, or self for the agent that owns this configuration.
One agent in a predefined_agents list. It is an agent ID string, an agent reference with an optional version, or self for the agent that owns this configuration.
class BetaManagedAgentsAgentParams { type; id; version; }Specification for an Agent. Provide a specific version or use the short-form agent="agent_id" for the most recent version
Specification for an Agent. Provide a specific version or use the short-form agent="agent_id" for the most recent version
String idThe agent ID.
The agent ID.
Optional<Long> versionThe specific agent version to use. Omit to use the latest version. Must be at least 1 if specified.
The specific agent version to use. Omit to use the latest version. Must be at least 1 if specified.
class BetaManagedAgentsMultiagentSelfParams { type; }Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
class BetaManagedAgentsMultiagentSelfParams { type; }Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
class BetaManagedAgentsMultiagentSubagents: unionWhether the agent can spawn session threads.
Whether the agent can spawn session threads.
class BetaManagedAgentsMultiagentSubagentsEnabled { type = "enabled"; inlineAgents; predefinedAgents; }The agent can spawn session threads.
The agent can spawn session threads.
class BetaManagedAgentsMultiagentSubagentsDisabled { type = "disabled"; }The agent cannot spawn session threads.
The agent cannot spawn session threads.
class BetaManagedAgentsMultiagentSubagentsDisabled { type = "disabled"; }The agent cannot spawn session threads.
The agent cannot spawn session threads.
class BetaManagedAgentsMultiagentSubagentsDisabledParams { type = "disabled"; }The agent cannot spawn session threads.
The agent cannot spawn session threads.
class BetaManagedAgentsMultiagentSubagentsEnabled { type = "enabled"; inlineAgents; predefinedAgents; }The agent can spawn session threads.
The agent can spawn session threads.
class BetaManagedAgentsMultiagentSubagentsEnabledParams { type = "enabled"; inlineAgents; predefinedAgents; }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.
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.
class BetaManagedAgentsMultiagentSubagentsParams: unionWhether the agent can spawn session threads.
Whether the agent can spawn session threads.
class BetaManagedAgentsMultiagentSubagentsEnabledParams { type = "enabled"; inlineAgents; predefinedAgents; }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.
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.
class BetaManagedAgentsMultiagentSubagentsDisabledParams { type = "disabled"; }The agent cannot spawn session threads.
The agent cannot spawn session threads.
class BetaManagedAgentsMultiagentWorkflows: unionWhether the agent can start workflow runs.
Whether the agent can start workflow runs.
class BetaManagedAgentsMultiagentWorkflowsEnabled { type = "enabled"; inlineAgents; predefinedAgents; }The agent can start workflow runs.
The agent can start workflow runs.
class BetaManagedAgentsMultiagentWorkflowsDisabled { type = "disabled"; }The agent cannot start workflow runs.
The agent cannot start workflow runs.
class BetaManagedAgentsMultiagentWorkflowsDisabled { type = "disabled"; }The agent cannot start workflow runs.
The agent cannot start workflow runs.
class BetaManagedAgentsMultiagentWorkflowsDisabledParams { type = "disabled"; }The agent cannot start workflow runs.
The agent cannot start workflow runs.
class BetaManagedAgentsMultiagentWorkflowsEnabled { type = "enabled"; inlineAgents; predefinedAgents; }The agent can start workflow runs.
The agent can start workflow runs.
class BetaManagedAgentsMultiagentWorkflowsEnabledParams { type = "enabled"; inlineAgents; predefinedAgents; }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.
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.
class BetaManagedAgentsMultiagentWorkflowsParams: unionWhether the agent can start workflow runs.
Whether the agent can start workflow runs.
class BetaManagedAgentsMultiagentWorkflowsEnabledParams { type = "enabled"; inlineAgents; predefinedAgents; }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.
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.
class BetaManagedAgentsMultiagentWorkflowsDisabledParams { type = "disabled"; }The agent cannot start workflow runs.
The agent cannot start workflow runs.
class BetaManagedAgentsMultiagent20261001 { type = "multiagent_20261001"; advisor; subagents; workflows; }Resolved multiagent configuration with three members, each enabled or disabled on its own.
Resolved multiagent configuration with three members, each enabled or disabled on its own.
class BetaManagedAgentsMultiagent20261001Params { type = "multiagent_20261001"; advisor; subagents; workflows; }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.
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.
class BetaManagedAgentsReadToolConfig { type = "read"; enabled; name; permissionPolicy; }Configuration for the read tool.
Configuration for the read tool.
PermissionPolicy permissionPolicyPermission policy for tool execution.
Permission policy for tool execution.
class BetaManagedAgentsAlwaysAllowPolicy { type; }Tool calls are automatically approved without user confirmation.
Tool calls are automatically approved without user confirmation.
class BetaManagedAgentsAlwaysAskPolicy { type; }Tool calls require user confirmation before execution.
Tool calls require user confirmation before execution.
class BetaManagedAgentsAutoPolicy { type = "auto"; }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.
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.
class BetaManagedAgentsReadToolConfigParams { type; name; enabled; permissionPolicy; }Configuration override for the read tool.
Configuration override for the read tool.
class BetaManagedAgentsServiceAccountExecutionIdentity { type = "service_account"; }The Anthropic-managed service account as returned in API responses.
The Anthropic-managed service account as returned in API responses.
class BetaManagedAgentsServiceAccountExecutionIdentityParams { type = "service_account"; }The Anthropic-managed service account — the default execution principal. Carries no identifier.
The Anthropic-managed service account — the default execution principal. Carries no identifier.
class BetaManagedAgentsSessionThreadAgent { type; id; description; /* 8 more */ }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.
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.
class BetaManagedAgentsSkillParams: unionSkill to load in the session container.
Skill to load in the session container.
class BetaManagedAgentsAnthropicSkillParams { type; skillId; version; }An Anthropic-managed skill.
An Anthropic-managed skill.
String skillIdIdentifier of the Anthropic skill (e.g., "xlsx").
Identifier of the Anthropic skill (e.g., "xlsx").
Optional<String> versionVersion to pin. Defaults to latest if omitted.
Version to pin. Defaults to latest if omitted.
class BetaManagedAgentsCustomSkillParams { type; skillId; version; }A user-created custom skill.
A user-created custom skill.
String skillIdTagged ID of the custom skill (e.g., "skill_01XJ5...").
Tagged ID of the custom skill (e.g., "skill_01XJ5...").
Optional<String> versionVersion to pin. Defaults to latest if omitted.
Version to pin. Defaults to latest if omitted.
class BetaManagedAgentsUrlMcpServerParams { type; name; url; }URL-based MCP server connection.
URL-based MCP server connection.
String nameUnique name for this server, referenced by mcp_toolset configurations. 1-255 characters.
Unique name for this server, referenced by mcp_toolset configurations. 1-255 characters.
String urlEndpoint URL for the MCP server.
Endpoint URL for the MCP server.
class BetaManagedAgentsUserLocation { type = "approximate"; city; country; /* 2 more */ }Approximate user location for search result localization.
Approximate user location for search result localization.
Location precision. Only "approximate" is supported.
Optional<String> cityCity name.
City name.
Two-letter ISO 3166-1 country code, uppercase.
Optional<String> regionRegion or state name.
Region or state name.
Optional<String> timezoneIANA timezone identifier, e.g. "America/Los_Angeles".
IANA timezone identifier, e.g. "America/Los_Angeles".
class BetaManagedAgentsWebFetchToolConfig { type = "web_fetch"; enabled; name; /* 5 more */ }Configuration for the web_fetch tool.
Configuration for the web_fetch tool.
class BetaManagedAgentsWebFetchToolConfigParams { type; name; allowedDomains; /* 5 more */ }Configuration override for the web_fetch tool.
Configuration override for the web_fetch tool.
class BetaManagedAgentsWebFetchUrlSourceAll { type = "all"; }Every URL from this source may be fetched. This is the default.
Every URL from this source may be fetched. This is the default.
class BetaManagedAgentsWebFetchUrlSourceExcept { type = "except"; tools; }Every tool's results contribute URLs that may be fetched, except the named tools' results.
Every tool's results contribute URLs that may be fetched, except the named tools' results.
List<BetaManagedAgentsWebFetchUrlSourceToolReference> toolsThe 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.
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.
Must be "tool_reference".
String nameName of the tool. Compared exactly, so upper and lower case letters are different.
Name of the tool. Compared exactly, so upper and lower case letters are different.
class BetaManagedAgentsWebFetchUrlSourceNone { type = "none"; }This source contributes no URLs that may be fetched.
This source contributes no URLs that may be fetched.
class BetaManagedAgentsWebFetchUrlSourceOnly { type = "only"; tools; }Only the named tools' results contribute URLs that may be fetched.
Only the named tools' results contribute URLs that may be fetched.
List<BetaManagedAgentsWebFetchUrlSourceToolReference> toolsThe 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.
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.
Must be "tool_reference".
String nameName of the tool. Compared exactly, so upper and lower case letters are different.
Name of the tool. Compared exactly, so upper and lower case letters are different.
enum BetaManagedAgentsWebFetchUrlSourceShorthandString form of a url_sources value that has no field other than its type: "all" means {"type": "all"} and "none" means {"type": "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"}.
class BetaManagedAgentsWebFetchUrlSourceToolFilter: unionWhich tools' results contribute URLs that may be fetched.
Which tools' results contribute URLs that may be fetched.
class BetaManagedAgentsWebFetchUrlSourceToolFilterParams: unionWhich tools' results contribute URLs that may be fetched. Accepts the string "all" or "none", or an object whose type is "all", "none", "only" or "except". Responses use the object form.
Which tools' results contribute URLs that may be fetched. Accepts the string "all" or "none", or an object whose type is "all", "none", "only" or "except". Responses use the object form.
enum BetaManagedAgentsWebFetchUrlSourceShorthandString form of a url_sources value that has no field other than its type: "all" means {"type": "all"} and "none" means {"type": "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"}.
class BetaManagedAgentsWebFetchUrlSourceToolFilter: unionWhich tools' results contribute URLs that may be fetched.
Which tools' results contribute URLs that may be fetched.
class BetaManagedAgentsWebFetchUrlSourceToolReference { type = "tool_reference"; name; }Names one tool in an only or except list.
Names one tool in an only or except list.
Must be "tool_reference".
String nameName of the tool. Compared exactly, so upper and lower case letters are different.
Name of the tool. Compared exactly, so upper and lower case letters are different.
class BetaManagedAgentsWebFetchUrlSourceUserInput: unionWhether URLs in the text of user messages may be fetched.
Whether URLs in the text of user messages may be fetched.
class BetaManagedAgentsWebFetchUrlSourceAll { type = "all"; }Every URL from this source may be fetched. This is the default.
Every URL from this source may be fetched. This is the default.
class BetaManagedAgentsWebFetchUrlSourceNone { type = "none"; }This source contributes no URLs that may be fetched.
This source contributes no URLs that may be fetched.
class BetaManagedAgentsWebFetchUrlSourceUserInputParams: unionWhether URLs in the text of user messages may be fetched. Accepts the string "all" or "none", or the object {"type": "all"} or {"type": "none"}. Responses use the object form.
Whether URLs in the text of user messages may be fetched. Accepts the string "all" or "none", or the object {"type": "all"} or {"type": "none"}. Responses use the object form.
enum BetaManagedAgentsWebFetchUrlSourceShorthandString form of a url_sources value that has no field other than its type: "all" means {"type": "all"} and "none" means {"type": "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"}.
class BetaManagedAgentsWebFetchUrlSourceUserInput: unionWhether URLs in the text of user messages may be fetched.
Whether URLs in the text of user messages may be fetched.
class BetaManagedAgentsWebFetchUrlSourceAll { type = "all"; }Every URL from this source may be fetched. This is the default.
Every URL from this source may be fetched. This is the default.
class BetaManagedAgentsWebFetchUrlSourceNone { type = "none"; }This source contributes no URLs that may be fetched.
This source contributes no URLs that may be fetched.
class BetaManagedAgentsWebFetchUrlSources { clientToolResults; serverToolResults; userInput; }Which sources contribute URLs the web_fetch tool may fetch. A key that is null was not set and allows every URL from that source.
Which sources contribute URLs the web_fetch tool may fetch. A key that is null was not set and allows every URL from that source.
Optional<BetaManagedAgentsWebFetchUrlSourceToolFilter> clientToolResultsWhich custom tools' results contribute URLs that may be fetched. Null when not set, which allows every custom tool's results.
Which custom tools' results contribute URLs that may be fetched. Null when not set, which allows every custom tool's results.
Optional<BetaManagedAgentsWebFetchUrlSourceToolFilter> serverToolResultsWhich of the web_search and web_fetch tools' results contribute URLs that may be fetched. Null when not set, which allows both.
Which of the web_search and web_fetch tools' results contribute URLs that may be fetched. Null when not set, which allows both.
Optional<BetaManagedAgentsWebFetchUrlSourceUserInput> userInputWhether URLs in the text of user messages may be fetched. Null when not set, which allows them.
Whether URLs in the text of user messages may be fetched. Null when not set, which allows them.
class BetaManagedAgentsWebFetchUrlSourceAll { type = "all"; }Every URL from this source may be fetched. This is the default.
Every URL from this source may be fetched. This is the default.
class BetaManagedAgentsWebFetchUrlSourceNone { type = "none"; }This source contributes no URLs that may be fetched.
This source contributes no URLs that may be fetched.
class BetaManagedAgentsWebFetchUrlSourcesParams { clientToolResults; serverToolResults; userInput; }Which sources contribute URLs the web_fetch tool may fetch. When web_fetch is limited to URLs the conversation has already shown the model (in a user message, a custom tool's result, or an earlier web_search or web_fetch result), each key narrows one of those sources and defaults to "all". Setting all three keys to "none" is rejected.
Which sources contribute URLs the web_fetch tool may fetch. When web_fetch is limited to URLs the conversation has already shown the model (in a user message, a custom tool's result, or an earlier web_search or web_fetch result), each key narrows one of those sources and defaults to "all". Setting all three keys to "none" is rejected.
class BetaManagedAgentsWebSearchToolConfig { type = "web_search"; enabled; name; /* 4 more */ }Configuration for the web_search tool.
Configuration for the web_search tool.
class BetaManagedAgentsWebSearchToolConfigParams { type; name; allowedDomains; /* 4 more */ }Configuration override for the web_search tool.
Configuration override for the web_search tool.
class BetaManagedAgentsWriteToolConfig { type = "write"; enabled; name; permissionPolicy; }Configuration for the write tool.
Configuration for the write tool.
PermissionPolicy permissionPolicyPermission policy for tool execution.
Permission policy for tool execution.
class BetaManagedAgentsAlwaysAllowPolicy { type; }Tool calls are automatically approved without user confirmation.
Tool calls are automatically approved without user confirmation.
class BetaManagedAgentsAlwaysAskPolicy { type; }Tool calls require user confirmation before execution.
Tool calls require user confirmation before execution.
class BetaManagedAgentsAutoPolicy { type = "auto"; }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.
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.
class BetaManagedAgentsWriteToolConfigParams { type; name; enabled; permissionPolicy; }Configuration override for the write tool.
Configuration override for the write tool.