One change
update
api/beta/sessions/update
Nearest release: v2.1.239, published 2 hours before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
api/beta/sessions/update Changed · +577 / -115 lines
The two sides of this change are too far apart to line up, so this is the differ's own diff of it.
from line 129
Per-tool configuration overrides. - - `name: "bash" or "edit" or "read" or 5 more` - - Built-in agent tool identifier. - - - `"bash"` - - - `"edit"` - - - `"read"` - - - `"write"` - - - `"glob"` - - - `"grep"` - - - `"web_fetch"` - - - `"web_search"` + - `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }` + + Configuration override for the bash tool. + + - `name: "bash"` + + Must be "bash". + + - `"bash"` + + - `enabled: optional boolean or null` + + Whether this tool is enabled and available to Claude. Overrides the default_config setting. + + - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `type: "always_allow"` + + - `"always_allow"` + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: "always_ask"` + + - `"always_ask"` + + - `type: optional "bash"` + + - `"bash"` + + - `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }` + + Configuration override for the edit tool. + + - `name: "edit"` + + Must be "edit". + + - `"edit"` + + - `enabled: optional boolean or null` + + Whether this tool is enabled and available to Claude. Overrides the default_config setting. + + - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: optional "edit"` + + - `"edit"` + + - `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }` + + Configuration override for the read tool. + + - `name: "read"` + + Must be "read". + + - `"read"` + + - `enabled: optional boolean or null` + + Whether this tool is enabled and available to Claude. Overrides the default_config setting. + + - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: optional "read"` + + - `"read"` + + - `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }` + + Configuration override for the write tool. + + - `name: "write"` + + Must be "write". + + - `"write"` + + - `enabled: optional boolean or null` + + Whether this tool is enabled and available to Claude. Overrides the default_config setting. + + - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: optional "write"` + + - `"write"` + + - `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }` + + Configuration override for the glob tool. + + - `name: "glob"` + + Must be "glob". + + - `"glob"` + + - `enabled: optional boolean or null` + + Whether this tool is enabled and available to Claude. Overrides the default_config setting. + + - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: optional "glob"` + + - `"glob"` + + - `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }` + + Configuration override for the grep tool. + + - `name: "grep"` + + Must be "grep". + + - `"grep"` + + - `enabled: optional boolean or null` + + Whether this tool is enabled and available to Claude. Overrides the default_config setting. + + - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: optional "grep"` + + - `"grep"` + + - `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }` + + Configuration override for the web_fetch tool. + + - `name: "web_fetch"` + + Must be "web_fetch". + + - `"web_fetch"` + + - `allowed_domains: optional array of string` + + Only fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains. + + - `blocked_domains: optional array of string` + + 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: optional boolean or null` + + Whether this tool is enabled and available to Claude. Overrides the default_config setting. + + - `max_content_tokens: optional number or null` + + Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs. + + - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: optional "web_fetch"` + + - `"web_fetch"` + + - `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }` + + Configuration override for the web_search tool. + + - `name: "web_search"` + + Must be "web_search". + + - `"web_search"` + + - `allowed_domains: optional array of string` + + Only return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains. + + - `blocked_domains: optional array of string` + + Never return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains. + + - `enabled: optional boolean or null` + + Whether this tool is enabled and available to Claude. Overrides the default_config setting. + + - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: optional "web_search"` + + - `"web_search"` + + - `user_location: optional BetaManagedAgentsUserLocation or null` + + Approximate user location for search result localization. + + - `type: "approximate"` + + Location precision. Only "approximate" is supported. + + - `"approximate"` + + - `city: optional string or null` + + City name. + + - `country: optional string or null` + + Two-letter ISO 3166-1 country code, uppercase. + + - `region: optional string or null` + + Region or state name. + + - `timezone: optional string or null` + + IANA timezone identifier, e.g. "America/Los_Angeles". + + - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null` + + Default configuration for all tools in a toolset. - `enabled: optional boolean or null` - Whether this tool is enabled and available to Claude. Overrides the default_config setting. + Whether tools are enabled and available to Claude by default. Defaults to true if not specified. - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
from line 439
Tool calls are automatically approved without user confirmation. - - `type: "always_allow"` - - - `"always_allow"` - - `BetaManagedAgentsAlwaysAskPolicy object { type }` Tool calls require user confirmation before execution. - - `type: "always_ask"` - - - `"always_ask"` - - - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null` - - Default configuration for all tools in a toolset. + - `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }` + + Configuration for tools from an MCP server defined in `mcp_servers`. + + - `mcp_server_name: string` + + Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters. + + - `type: "mcp_toolset"` + + - `"mcp_toolset"` + + - `configs: optional array of BetaManagedAgentsMCPToolConfigParams` + + Per-tool configuration overrides. + + - `name: string` + + Name of the MCP tool to configure. 1-128 characters. - `enabled: optional boolean or null` - Whether tools are enabled and available to Claude by default. Defaults to true if not specified. + Whether this tool is enabled. Overrides the `default_config` setting. - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
from line 479
Tool calls require user confirmation before execution. - - `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }` - - Configuration for tools from an MCP server defined in `mcp_servers`. - - - `mcp_server_name: string` - - Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters. - - - `type: "mcp_toolset"` - - - `"mcp_toolset"` - - - `configs: optional array of BetaManagedAgentsMCPToolConfigParams` - - Per-tool configuration overrides. - - - `name: string` - - Name of the MCP tool to configure. 1-128 characters. + - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null` + + Default configuration for all tools from an MCP server. - `enabled: optional boolean or null` - Whether this tool is enabled. Overrides the `default_config` setting. + Whether tools are enabled by default. Defaults to true if not specified. - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
from line 499
Tool calls require user confirmation before execution. - - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null` - - Default configuration for all tools from an MCP server. - - - `enabled: optional boolean or null` - - Whether tools are enabled by default. Defaults to true if not specified. - - - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null` - - Permission policy for tool execution. - - - `BetaManagedAgentsAlwaysAllowPolicy object { type }` - - Tool calls are automatically approved without user confirmation. - - - `BetaManagedAgentsAlwaysAskPolicy object { type }` - - Tool calls require user confirmation before execution. - - `BetaManagedAgentsCustomToolParams object { description, input_schema, name, type }` 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.
from line 777
- `configs: array of BetaManagedAgentsAgentToolConfig` - - `enabled: boolean` - - - `name: "bash" or "edit" or "read" or 5 more` - - Built-in agent tool identifier. - - - `"bash"` - - - `"edit"` - - - `"read"` - - - `"write"` - - - `"glob"` - - - `"grep"` - - - `"web_fetch"` - - - `"web_search"` - - - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy` - - Permission policy for tool execution. - - - `BetaManagedAgentsAlwaysAllowPolicy object { type }` - - Tool calls are automatically approved without user confirmation. - - - `type: "always_allow"` - - - `"always_allow"` - - - `BetaManagedAgentsAlwaysAskPolicy object { type }` - - Tool calls require user confirmation before execution. - - - `type: "always_ask"` - - - `"always_ask"` + - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }` + + Configuration for the bash tool. + + - `enabled: boolean` + + - `name: "bash"` + + - `"bash"` + + - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `type: "always_allow"` + + - `"always_allow"` + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: "always_ask"` + + - `"always_ask"` + + - `type: "bash"` + + - `"bash"` + + - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }` + + Configuration for the edit tool. + + - `enabled: boolean` + + - `name: "edit"` + + - `"edit"` + + - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: "edit"` + + - `"edit"` + + - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }` + + Configuration for the read tool. + + - `enabled: boolean` + + - `name: "read"` + + - `"read"` + + - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: "read"` + + - `"read"` + + - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }` + + Configuration for the write tool. + + - `enabled: boolean` + + - `name: "write"` + + - `"write"` + + - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: "write"` + + - `"write"` + + - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }` + + Configuration for the glob tool. + + - `enabled: boolean` + + - `name: "glob"` + + - `"glob"` + + - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: "glob"` + + - `"glob"` + + - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }` + + Configuration for the grep tool. + + - `enabled: boolean` + + - `name: "grep"` + + - `"grep"` + + - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: "grep"` + + - `"grep"` + + - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }` + + Configuration for the web_fetch tool. + + - `enabled: boolean` + + - `name: "web_fetch"` + + - `"web_fetch"` + + - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: "web_fetch"` + + - `"web_fetch"` + + - `allowed_domains: optional array of string` + + - `blocked_domains: optional array of string` + + - `max_content_tokens: optional number or null` + + - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }` + + Configuration for the web_search tool. + + - `enabled: boolean` + + - `name: "web_search"` + + - `"web_search"` + + - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy` + + Permission policy for tool execution. + + - `BetaManagedAgentsAlwaysAllowPolicy object { type }` + + Tool calls are automatically approved without user confirmation. + + - `BetaManagedAgentsAlwaysAskPolicy object { type }` + + Tool calls require user confirmation before execution. + + - `type: "web_search"` + + - `"web_search"` + + - `allowed_domains: optional array of string` + + - `blocked_domains: optional array of string` + + - `user_location: optional BetaManagedAgentsUserLocation or null` + + Approximate user location for search result localization. + + - `type: "approximate"` + + Location precision. Only "approximate" is supported. + + - `"approximate"` + + - `city: optional string or null` + + City name. + + - `country: optional string or null` + + Two-letter ISO 3166-1 country code, uppercase. + + - `region: optional string or null` + + Region or state name. + + - `timezone: optional string or null` + + IANA timezone identifier, e.g. "America/Los_Angeles". - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
from line 1500
"name": "bash", "permission_policy": { "type": "always_allow" - } + }, + "type": "bash" } ], "default_config": {
from line 1541
"name": "bash", "permission_policy": { "type": "always_allow" - } + }, + "type": "bash" } ], "default_config": {