List Session Thread Events changedapi/beta/sessions/threads/events/list
Nearest release: v2.1.296, published 4 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.
Recorded here
Lines+833added
Lines−439removed
From line
381
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits21to this page, all time
The whole hunk
from line 381, old and new numbered
/
The two sides of this change are more than 400 edits apart, too far apart to line up, so this is the differ's own diff of it and the words inside a line are not marked.
from line 381
381381
382382 - `custom_tool_use_id: string`
383383
384 The id of the `agent.custom_tool_use` event this result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field.
384 The id of the `agent.custom_tool_use` event this result corresponds to. It is also listed in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field.
385385
386386 - `content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock`
387387
from line 453
453453
454454 - `BetaManagedAgentsAgentCustomToolUseEvent object`
455455
456 Event emitted when the agent calls a custom tool. The session goes idle until the client sends a `user.custom_tool_result` event with the result.
456 Event emitted when the agent calls a custom tool. The session goes idle until the client sends a `user.custom_tool_result` event with the result. The client can send it as soon as this event arrives, without waiting for `session.status_idle`.
457457
458458 - `type: "agent.custom_tool_use"`
459459
from line 1395
13951395
13961396 Public `sthr_` ID of the newly created thread.
13971397
1398 - `workflow_run_id: string or null`
1399
1400 Identifier of the workflow run that created the thread, or `null` for any other thread.
1401
13981402 - `BetaManagedAgentsSpanOutcomeEvaluationStartEvent object`
13991403
14001404 Emitted when an outcome evaluation cycle begins.
from line 1899
18951899
18961900 - `"claude-haiku-4-5"`
18971901
1898 Fastest model with near-frontier intelligence
1899
19001902 - `"claude-haiku-4-5-20251001"`
19011903
1902 Fastest model with near-frontier intelligence
1903
19041904 - `"claude-opus-4-5"`
19051905
19061906 Powerful intelligence for long-running agents and coding
from line 1969
19691969
19701970 - `"fast"`
19711971
1972 - `multiagent: BetaManagedAgentsSessionMultiagentCoordinator or null`
1972 - `multiagent: BetaManagedAgentsSessionMultiagent or null`
19731973
19741974 Resolved multiagent orchestration configuration. Null when the agent is single-threaded.
19751975
1976 - `type: "coordinator"`
1977
1978 - `agents: array of BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
1979
1980 Full `agent` definitions the coordinator may spawn as session threads.
1981
1982 - `BetaManagedAgentsSessionThreadAgent object`
1983
1984 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`.
1985
1986 - `type: "agent"`
1987
1988 - `id: string`
1989
1990 - `description: string or null`
1991
1992 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
1993
1994 - `type: "url"`
1976 - `BetaManagedAgentsSessionMultiagentCoordinator object`
1977
1978 Resolved coordinator topology with full agent definitions for each roster member.
1979
1980 - `type: "coordinator"`
1981
1982 - `agents: array of BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
1983
1984 Full `agent` definitions the coordinator may spawn as session threads.
1985
1986 - `BetaManagedAgentsSessionThreadAgent object`
1987
1988 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`.
1989
1990 - `type: "agent"`
1991
1992 - `id: string`
1993
1994 - `description: string or null`
1995
1996 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
1997
1998 - `type: "url"`
1999
2000 - `name: string`
2001
2002 - `url: string`
2003
2004 - `model: BetaManagedAgentsModelConfig`
2005
2006 Model identifier and configuration.
19952007
19962008 - `name: string`
19972009
1998 - `url: string`
1999
2000 - `model: BetaManagedAgentsModelConfig`
2001
2002 Model identifier and configuration.
2003
2004 - `name: string`
2005
2006 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
2007
2008 - `BetaManagedAgentsAnthropicSkill object`
2009
2010 A resolved Anthropic-managed skill.
2011
2012 - `type: "anthropic"`
2013
2014 - `skill_id: string`
2015
2016 - `version: string`
2017
2018 - `BetaManagedAgentsCustomSkill object`
2019
2020 A resolved user-created custom skill.
2021
2022 - `type: "custom"`
2023
2024 - `skill_id: string`
2025
2026 - `version: string`
2027
2028 - `system: string or null`
2029
2030 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
2031
2032 - `BetaManagedAgentsAgentToolset20260401 object`
2033
2034 - `type: "agent_toolset_20260401"`
2035
2036 - `configs: array of BetaManagedAgentsAgentToolConfig`
2037
2038 - `BetaManagedAgentsBashToolConfig object`
2039
2040 Configuration for the bash tool.
2041
2042 - `type: "bash"`
2010 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
2011
2012 - `BetaManagedAgentsAnthropicSkill object`
2013
2014 A resolved Anthropic-managed skill.
2015
2016 - `type: "anthropic"`
2017
2018 - `skill_id: string`
2019
2020 - `version: string`
2021
2022 - `BetaManagedAgentsCustomSkill object`
2023
2024 A resolved user-created custom skill.
2025
2026 - `type: "custom"`
2027
2028 - `skill_id: string`
2029
2030 - `version: string`
2031
2032 - `system: string or null`
2033
2034 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
2035
2036 - `BetaManagedAgentsAgentToolset20260401 object`
2037
2038 - `type: "agent_toolset_20260401"`
2039
2040 - `configs: array of BetaManagedAgentsAgentToolConfig`
2041
2042 - `BetaManagedAgentsBashToolConfig object`
2043
2044 Configuration for the bash tool.
2045
2046 - `type: "bash"`
2047
2048 - `enabled: boolean`
2049
2050 - `name: "bash"`
2051
2052 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2053
2054 Permission policy for tool execution.
2055
2056 - `BetaManagedAgentsAlwaysAllowPolicy object`
2057
2058 Tool calls are automatically approved without user confirmation.
2059
2060 - `type: "always_allow"`
2061
2062 - `BetaManagedAgentsAlwaysAskPolicy object`
2063
2064 Tool calls require user confirmation before execution.
2065
2066 - `type: "always_ask"`
2067
2068 - `BetaManagedAgentsAutoPolicy object`
2069
2070 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.
2071
2072 - `type: "auto"`
2073
2074 - `BetaManagedAgentsEditToolConfig object`
2075
2076 Configuration for the edit tool.
2077
2078 - `type: "edit"`
2079
2080 - `enabled: boolean`
2081
2082 - `name: "edit"`
2083
2084 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2085
2086 Permission policy for tool execution.
2087
2088 - `BetaManagedAgentsAlwaysAllowPolicy object`
2089
2090 Tool calls are automatically approved without user confirmation.
2091
2092 - `BetaManagedAgentsAlwaysAskPolicy object`
2093
2094 Tool calls require user confirmation before execution.
2095
2096 - `BetaManagedAgentsAutoPolicy object`
2097
2098 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.
2099
2100 - `BetaManagedAgentsReadToolConfig object`
2101
2102 Configuration for the read tool.
2103
2104 - `type: "read"`
2105
2106 - `enabled: boolean`
2107
2108 - `name: "read"`
2109
2110 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2111
2112 Permission policy for tool execution.
2113
2114 - `BetaManagedAgentsAlwaysAllowPolicy object`
2115
2116 Tool calls are automatically approved without user confirmation.
2117
2118 - `BetaManagedAgentsAlwaysAskPolicy object`
2119
2120 Tool calls require user confirmation before execution.
2121
2122 - `BetaManagedAgentsAutoPolicy object`
2123
2124 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.
2125
2126 - `BetaManagedAgentsWriteToolConfig object`
2127
2128 Configuration for the write tool.
2129
2130 - `type: "write"`
2131
2132 - `enabled: boolean`
2133
2134 - `name: "write"`
2135
2136 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2137
2138 Permission policy for tool execution.
2139
2140 - `BetaManagedAgentsAlwaysAllowPolicy object`
2141
2142 Tool calls are automatically approved without user confirmation.
2143
2144 - `BetaManagedAgentsAlwaysAskPolicy object`
2145
2146 Tool calls require user confirmation before execution.
2147
2148 - `BetaManagedAgentsAutoPolicy object`
2149
2150 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.
2151
2152 - `BetaManagedAgentsGlobToolConfig object`
2153
2154 Configuration for the glob tool.
2155
2156 - `type: "glob"`
2157
2158 - `enabled: boolean`
2159
2160 - `name: "glob"`
2161
2162 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2163
2164 Permission policy for tool execution.
2165
2166 - `BetaManagedAgentsAlwaysAllowPolicy object`
2167
2168 Tool calls are automatically approved without user confirmation.
2169
2170 - `BetaManagedAgentsAlwaysAskPolicy object`
2171
2172 Tool calls require user confirmation before execution.
2173
2174 - `BetaManagedAgentsAutoPolicy object`
2175
2176 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.
2177
2178 - `BetaManagedAgentsGrepToolConfig object`
2179
2180 Configuration for the grep tool.
2181
2182 - `type: "grep"`
2183
2184 - `enabled: boolean`
2185
2186 - `name: "grep"`
2187
2188 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2189
2190 Permission policy for tool execution.
2191
2192 - `BetaManagedAgentsAlwaysAllowPolicy object`
2193
2194 Tool calls are automatically approved without user confirmation.
2195
2196 - `BetaManagedAgentsAlwaysAskPolicy object`
2197
2198 Tool calls require user confirmation before execution.
2199
2200 - `BetaManagedAgentsAutoPolicy object`
2201
2202 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.
2203
2204 - `BetaManagedAgentsWebFetchToolConfig object`
2205
2206 Configuration for the web_fetch tool.
2207
2208 - `type: "web_fetch"`
2209
2210 - `enabled: boolean`
2211
2212 - `name: "web_fetch"`
2213
2214 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2215
2216 Permission policy for tool execution.
2217
2218 - `BetaManagedAgentsAlwaysAllowPolicy object`
2219
2220 Tool calls are automatically approved without user confirmation.
2221
2222 - `BetaManagedAgentsAlwaysAskPolicy object`
2223
2224 Tool calls require user confirmation before execution.
2225
2226 - `BetaManagedAgentsAutoPolicy object`
2227
2228 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.
2229
2230 - `url_sources: BetaManagedAgentsWebFetchURLSources or null`
2231
2232 Which sources contribute URLs the tool may fetch, always in the object form. Null when not set, which allows every source.
2233
2234 - `client_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
2235
2236 Which custom tools' results contribute URLs that may be fetched. Null when not set, which allows every custom tool's results.
2237
2238 - `BetaManagedAgentsWebFetchURLSourceAll object`
2239
2240 Every URL from this source may be fetched. This is the default.
2241
2242 - `type: "all"`
2243
2244 - `BetaManagedAgentsWebFetchURLSourceNone object`
2245
2246 This source contributes no URLs that may be fetched.
2247
2248 - `type: "none"`
2249
2250 - `BetaManagedAgentsWebFetchURLSourceOnly object`
2251
2252 Only the named tools' results contribute URLs that may be fetched.
2253
2254 - `type: "only"`
2255
2256 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
2257
2258 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.
2259
2260 - `type: "tool_reference"`
2261
2262 Must be "tool_reference".
2263
2264 - `name: string`
2265
2266 Name of the tool. Compared exactly, so upper and lower case letters are different.
2267
2268 minLength: 1, maxLength: 128
2269
2270 - `BetaManagedAgentsWebFetchURLSourceExcept object`
2271
2272 Every tool's results contribute URLs that may be fetched, except the named tools' results.
2273
2274 - `type: "except"`
2275
2276 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
2277
2278 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.
2279
2280 - `type: "tool_reference"`
2281
2282 Must be "tool_reference".
2283
2284 - `name: string`
2285
2286 Name of the tool. Compared exactly, so upper and lower case letters are different.
2287
2288 minLength: 1, maxLength: 128
2289
2290 - `server_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
2291
2292 Which of the web_search and web_fetch tools' results contribute URLs that may be fetched. Null when not set, which allows both.
2293
2294 - `user_input: BetaManagedAgentsWebFetchURLSourceUserInput or null`
2295
2296 Whether URLs in the text of user messages may be fetched. Null when not set, which allows them.
2297
2298 - `BetaManagedAgentsWebFetchURLSourceAll object`
2299
2300 Every URL from this source may be fetched. This is the default.
2301
2302 - `BetaManagedAgentsWebFetchURLSourceNone object`
2303
2304 This source contributes no URLs that may be fetched.
2305
2306 - `allowed_domains: optional array of string`
2307
2308 - `blocked_domains: optional array of string`
2309
2310 - `max_content_tokens: optional number or null`
2311
2312 format: int32
2313
2314 - `BetaManagedAgentsWebSearchToolConfig object`
2315
2316 Configuration for the web_search tool.
2317
2318 - `type: "web_search"`
2319
2320 - `enabled: boolean`
2321
2322 - `name: "web_search"`
2323
2324 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2325
2326 Permission policy for tool execution.
2327
2328 - `BetaManagedAgentsAlwaysAllowPolicy object`
2329
2330 Tool calls are automatically approved without user confirmation.
2331
2332 - `BetaManagedAgentsAlwaysAskPolicy object`
2333
2334 Tool calls require user confirmation before execution.
2335
2336 - `BetaManagedAgentsAutoPolicy object`
2337
2338 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.
2339
2340 - `allowed_domains: optional array of string`
2341
2342 - `blocked_domains: optional array of string`
2343
2344 - `user_location: optional BetaManagedAgentsUserLocation or null`
2345
2346 Approximate user location for search result localization.
2347
2348 - `type: "approximate"`
2349
2350 Location precision. Only "approximate" is supported.
2351
2352 - `city: optional string or null`
2353
2354 City name.
2355
2356 minLength: 1, maxLength: 255
2357
2358 - `country: optional string or null`
2359
2360 Two-letter ISO 3166-1 country code, uppercase.
2361
2362 - `region: optional string or null`
2363
2364 Region or state name.
2365
2366 minLength: 1, maxLength: 255
2367
2368 - `timezone: optional string or null`
2369
2370 IANA timezone identifier, e.g. "America/Los_Angeles".
2371
2372 minLength: 1, maxLength: 255
2373
2374 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
2375
2376 Resolved default configuration for agent tools.
20432377
20442378 - `enabled: boolean`
20452379
2046 - `name: "bash"`
2047
20482380 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
20492381
20502382 Permission policy for tool execution.
from line 2385
20532385
20542386 Tool calls are automatically approved without user confirmation.
20552387
2056 - `type: "always_allow"`
2057
20582388 - `BetaManagedAgentsAlwaysAskPolicy object`
20592389
20602390 Tool calls require user confirmation before execution.
20612391
2062 - `type: "always_ask"`
2063
20642392 - `BetaManagedAgentsAutoPolicy object`
20652393
20662394 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.
20672395
2068 - `type: "auto"`
2069
2070 - `BetaManagedAgentsEditToolConfig object`
2071
2072 Configuration for the edit tool.
2073
2074 - `type: "edit"`
2396 - `BetaManagedAgentsMCPToolset object`
2397
2398 - `type: "mcp_toolset"`
2399
2400 - `configs: array of BetaManagedAgentsMCPToolConfig`
20752401
20762402 - `enabled: boolean`
20772403
2078 - `name: "edit"`
2404 - `name: string`
20792405
20802406 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
20812407
from line 2419
20932419
20942420 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.
20952421
2096 - `BetaManagedAgentsReadToolConfig object`
2097
2098 Configuration for the read tool.
2099
2100 - `type: "read"`
2422 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
2423
2424 Resolved default configuration for all tools from an MCP server.
21012425
21022426 - `enabled: boolean`
21032427
2104 - `name: "read"`
2105
21062428 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
21072429
21082430 Permission policy for tool execution.
from line 2441
21192441
21202442 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.
21212443
2122 - `BetaManagedAgentsWriteToolConfig object`
2123
2124 Configuration for the write tool.
2125
2126 - `type: "write"`
2127
2128 - `enabled: boolean`
2129
2130 - `name: "write"`
2131
2132 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2133
2134 Permission policy for tool execution.
2135
2136 - `BetaManagedAgentsAlwaysAllowPolicy object`
2137
2138 Tool calls are automatically approved without user confirmation.
2139
2140 - `BetaManagedAgentsAlwaysAskPolicy object`
2141
2142 Tool calls require user confirmation before execution.
2143
2144 - `BetaManagedAgentsAutoPolicy object`
2145
2146 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.
2147
2148 - `BetaManagedAgentsGlobToolConfig object`
2149
2150 Configuration for the glob tool.
2151
2152 - `type: "glob"`
2153
2154 - `enabled: boolean`
2155
2156 - `name: "glob"`
2157
2158 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2159
2160 Permission policy for tool execution.
2161
2162 - `BetaManagedAgentsAlwaysAllowPolicy object`
2163
2164 Tool calls are automatically approved without user confirmation.
2165
2166 - `BetaManagedAgentsAlwaysAskPolicy object`
2167
2168 Tool calls require user confirmation before execution.
2169
2170 - `BetaManagedAgentsAutoPolicy object`
2171
2172 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.
2173
2174 - `BetaManagedAgentsGrepToolConfig object`
2175
2176 Configuration for the grep tool.
2177
2178 - `type: "grep"`
2179
2180 - `enabled: boolean`
2181
2182 - `name: "grep"`
2183
2184 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2185
2186 Permission policy for tool execution.
2187
2188 - `BetaManagedAgentsAlwaysAllowPolicy object`
2189
2190 Tool calls are automatically approved without user confirmation.
2191
2192 - `BetaManagedAgentsAlwaysAskPolicy object`
2193
2194 Tool calls require user confirmation before execution.
2195
2196 - `BetaManagedAgentsAutoPolicy object`
2197
2198 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.
2199
2200 - `BetaManagedAgentsWebFetchToolConfig object`
2201
2202 Configuration for the web_fetch tool.
2203
2204 - `type: "web_fetch"`
2205
2206 - `enabled: boolean`
2207
2208 - `name: "web_fetch"`
2209
2210 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2211
2212 Permission policy for tool execution.
2213
2214 - `BetaManagedAgentsAlwaysAllowPolicy object`
2215
2216 Tool calls are automatically approved without user confirmation.
2217
2218 - `BetaManagedAgentsAlwaysAskPolicy object`
2219
2220 Tool calls require user confirmation before execution.
2221
2222 - `BetaManagedAgentsAutoPolicy object`
2223
2224 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.
2225
2226 - `url_sources: BetaManagedAgentsWebFetchURLSources or null`
2227
2228 Which sources contribute URLs the tool may fetch, always in the object form. Null when not set, which allows every source.
2229
2230 - `client_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
2231
2232 Which custom tools' results contribute URLs that may be fetched. Null when not set, which allows every custom tool's results.
2233
2234 - `BetaManagedAgentsWebFetchURLSourceAll object`
2235
2236 Every URL from this source may be fetched. This is the default.
2237
2238 - `type: "all"`
2239
2240 - `BetaManagedAgentsWebFetchURLSourceNone object`
2241
2242 This source contributes no URLs that may be fetched.
2243
2244 - `type: "none"`
2245
2246 - `BetaManagedAgentsWebFetchURLSourceOnly object`
2247
2248 Only the named tools' results contribute URLs that may be fetched.
2249
2250 - `type: "only"`
2251
2252 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
2253
2254 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.
2255
2256 - `type: "tool_reference"`
2257
2258 Must be "tool_reference".
2259
2260 - `name: string`
2261
2262 Name of the tool. Compared exactly, so upper and lower case letters are different.
2263
2264 minLength: 1, maxLength: 128
2265
2266 - `BetaManagedAgentsWebFetchURLSourceExcept object`
2267
2268 Every tool's results contribute URLs that may be fetched, except the named tools' results.
2269
2270 - `type: "except"`
2271
2272 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
2273
2274 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.
2275
2276 - `type: "tool_reference"`
2277
2278 Must be "tool_reference".
2279
2280 - `name: string`
2281
2282 Name of the tool. Compared exactly, so upper and lower case letters are different.
2283
2284 minLength: 1, maxLength: 128
2285
2286 - `server_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
2287
2288 Which of the web_search and web_fetch tools' results contribute URLs that may be fetched. Null when not set, which allows both.
2289
2290 - `user_input: BetaManagedAgentsWebFetchURLSourceUserInput or null`
2291
2292 Whether URLs in the text of user messages may be fetched. Null when not set, which allows them.
2293
2294 - `BetaManagedAgentsWebFetchURLSourceAll object`
2295
2296 Every URL from this source may be fetched. This is the default.
2297
2298 - `BetaManagedAgentsWebFetchURLSourceNone object`
2299
2300 This source contributes no URLs that may be fetched.
2301
2302 - `allowed_domains: optional array of string`
2303
2304 - `blocked_domains: optional array of string`
2305
2306 - `max_content_tokens: optional number or null`
2307
2308 format: int32
2309
2310 - `BetaManagedAgentsWebSearchToolConfig object`
2311
2312 Configuration for the web_search tool.
2313
2314 - `type: "web_search"`
2315
2316 - `enabled: boolean`
2317
2318 - `name: "web_search"`
2319
2320 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2321
2322 Permission policy for tool execution.
2323
2324 - `BetaManagedAgentsAlwaysAllowPolicy object`
2325
2326 Tool calls are automatically approved without user confirmation.
2327
2328 - `BetaManagedAgentsAlwaysAskPolicy object`
2329
2330 Tool calls require user confirmation before execution.
2331
2332 - `BetaManagedAgentsAutoPolicy object`
2333
2334 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.
2335
2336 - `allowed_domains: optional array of string`
2337
2338 - `blocked_domains: optional array of string`
2339
2340 - `user_location: optional BetaManagedAgentsUserLocation or null`
2341
2342 Approximate user location for search result localization.
2343
2344 - `type: "approximate"`
2345
2346 Location precision. Only "approximate" is supported.
2347
2348 - `city: optional string or null`
2349
2350 City name.
2351
2352 minLength: 1, maxLength: 255
2353
2354 - `country: optional string or null`
2355
2356 Two-letter ISO 3166-1 country code, uppercase.
2357
2358 - `region: optional string or null`
2359
2360 Region or state name.
2361
2362 minLength: 1, maxLength: 255
2363
2364 - `timezone: optional string or null`
2365
2366 IANA timezone identifier, e.g. "America/Los_Angeles".
2367
2368 minLength: 1, maxLength: 255
2369
2370 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
2371
2372 Resolved default configuration for agent tools.
2373
2374 - `enabled: boolean`
2375
2376 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2377
2378 Permission policy for tool execution.
2379
2380 - `BetaManagedAgentsAlwaysAllowPolicy object`
2381
2382 Tool calls are automatically approved without user confirmation.
2383
2384 - `BetaManagedAgentsAlwaysAskPolicy object`
2385
2386 Tool calls require user confirmation before execution.
2387
2388 - `BetaManagedAgentsAutoPolicy object`
2389
2390 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.
2391
2392 - `BetaManagedAgentsMCPToolset object`
2393
2394 - `type: "mcp_toolset"`
2395
2396 - `configs: array of BetaManagedAgentsMCPToolConfig`
2397
2398 - `enabled: boolean`
2444 - `mcp_server_name: string`
2445
2446 - `BetaManagedAgentsCustomTool object`
2447
2448 A custom tool as returned in API responses.
2449
2450 - `type: "custom"`
2451
2452 - `description: string`
2453
2454 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
2455
2456 JSON Schema for custom tool input parameters.
2457
2458 - `type: "object"`
2459
2460 - `properties: optional map[unknown] or null`
2461
2462 - `required: optional array of string or null`
23992463
24002464 - `name: string`
24012465
2402 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2403
2404 Permission policy for tool execution.
2405
2406 - `BetaManagedAgentsAlwaysAllowPolicy object`
2407
2408 Tool calls are automatically approved without user confirmation.
2409
2410 - `BetaManagedAgentsAlwaysAskPolicy object`
2411
2412 Tool calls require user confirmation before execution.
2413
2414 - `BetaManagedAgentsAutoPolicy object`
2415
2416 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.
2417
2418 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
2419
2420 Resolved default configuration for all tools from an MCP server.
2421
2422 - `enabled: boolean`
2423
2424 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2425
2426 Permission policy for tool execution.
2427
2428 - `BetaManagedAgentsAlwaysAllowPolicy object`
2429
2430 Tool calls are automatically approved without user confirmation.
2431
2432 - `BetaManagedAgentsAlwaysAskPolicy object`
2433
2434 Tool calls require user confirmation before execution.
2435
2436 - `BetaManagedAgentsAutoPolicy object`
2437
2438 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.
2439
2440 - `mcp_server_name: string`
2441
2442 - `BetaManagedAgentsCustomTool object`
2443
2444 A custom tool as returned in API responses.
2445
2446 - `type: "custom"`
2447
2448 - `description: string`
2449
2450 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
2451
2452 JSON Schema for custom tool input parameters.
2453
2454 - `type: "object"`
2455
2456 - `properties: optional map[unknown] or null`
2457
2458 - `required: optional array of string or null`
2466 - `version: number`
2467
2468 format: int32
2469
2470 - `BetaManagedAgentsAdvisor object`
2471
2472 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
2473
2474 - `type: "advisor"`
2475
2476 - `model: string`
2477
2478 The advisor model id.
2479
2480 - `BetaManagedAgentsSessionMultiagent20261001 object`
2481
2482 Resolved multiagent configuration with three members, as copied to the `session` at creation.
2483
2484 - `type: "multiagent_20261001"`
2485
2486 - `advisor: BetaManagedAgentsMultiagentAdvisor`
2487
2488 Whether the session's primary thread can consult an advisor model.
2489
2490 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
2491
2492 The session's primary thread can consult `model` mid-turn.
2493
2494 - `type: "enabled"`
2495
2496 - `model: string`
2497
2498 The advisor model id.
2499
2500 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
2501
2502 The agent has no advisor.
2503
2504 - `type: "disabled"`
2505
2506 - `subagents: BetaManagedAgentsSessionMultiagentSubagents`
2507
2508 Whether the agent can spawn session threads.
2509
2510 - `BetaManagedAgentsSessionMultiagentSubagentsEnabled object`
2511
2512 The agent can spawn session threads.
2513
2514 - `type: "enabled"`
2515
2516 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
2517
2518 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
2519
2520 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
2521
2522 The agent can define inline agents.
2523
2524 - `type: "enabled"`
2525
2526 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
2527
2528 The agent cannot define inline agents.
2529
2530 - `type: "disabled"`
2531
2532 - `predefined_agents: array of BetaManagedAgentsSessionThreadAgent`
2533
2534 Full `agent` definitions of the predefined agents, which are saved agents that this agent can spawn as session threads.
2535
2536 - `type: "agent"`
2537
2538 - `id: string`
2539
2540 - `description: string or null`
2541
2542 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
2543
2544 - `model: BetaManagedAgentsModelConfig`
2545
2546 Model identifier and configuration.
24592547
24602548 - `name: string`
24612549
2462 - `version: number`
2463
2464 format: int32
2465
2466 - `BetaManagedAgentsAdvisor object`
2467
2468 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
2469
2470 - `type: "advisor"`
2471
2472 - `model: string`
2473
2474 The advisor model id.
2550 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
2551
2552 - `system: string or null`
2553
2554 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
2555
2556 - `version: number`
2557
2558 format: int32
2559
2560 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
2561
2562 The agent cannot spawn session threads.
2563
2564 - `type: "disabled"`
2565
2566 - `workflows: BetaManagedAgentsSessionMultiagentWorkflows`
2567
2568 Whether the agent can start workflow runs.
2569
2570 - `BetaManagedAgentsSessionMultiagentWorkflowsEnabled object`
2571
2572 The agent can start workflow runs.
2573
2574 - `type: "enabled"`
2575
2576 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
2577
2578 Whether a run's plan can define inline agents, which are not saved.
2579
2580 - `predefined_agents: array of BetaManagedAgentsSessionThreadAgent`
2581
2582 Full `agent` definitions of the predefined agents, which are saved agents that a run's plan can use.
2583
2584 - `type: "agent"`
2585
2586 - `id: string`
2587
2588 - `description: string or null`
2589
2590 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
2591
2592 - `model: BetaManagedAgentsModelConfig`
2593
2594 Model identifier and configuration.
2595
2596 - `name: string`
2597
2598 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
2599
2600 - `system: string or null`
2601
2602 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
2603
2604 - `version: number`
2605
2606 format: int32
2607
2608 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
2609
2610 The agent cannot start workflow runs.
2611
2612 - `type: "disabled"`
24752613
24762614 - `name: string`
24772615
from line 2776
26382776 - `budget: optional BetaManagedAgentsBudgetLimit or null`
26392777
26402778 The session's configured budget at the snapshot time, or null when the session has no budget.
2779
2780 - `BetaManagedAgentsWorkflowRunCreatedEvent object`
2781
2782 A workflow run was created. A workflow run is background work that the session's agent starts. Emitted once per run, before the run's other `workflow_run.*` events.
2783
2784 - `type: "workflow_run.created"`
2785
2786 - `id: string`
2787
2788 Unique identifier for this event.
2789
2790 - `description: string or null`
2791
2792 Description that the agent gave the run, passed on as written, or `null` if it gave none.
2793
2794 - `name: string`
2795
2796 Name that the agent gave the run, passed on as written, or a name that the server assigned.
2797
2798 - `phases: array of BetaManagedAgentsWorkflowRunPhase`
2799
2800 The phases that the run's plan declares, in the plan's order. Can be empty.
2801
2802 - `id: string`
2803
2804 Unique identifier for the phase.
2805
2806 - `description: string or null`
2807
2808 Description that the agent gave the phase, passed on as written, or `null` if it gave none.
2809
2810 - `name: string`
2811
2812 Name that the agent gave the phase, passed on as written.
2813
2814 - `processed_at: string`
2815
2816 Timestamp when this event was processed.
2817
2818 format: date-time
2819
2820 - `workflow_run_id: string`
2821
2822 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
2823
2824 - `BetaManagedAgentsWorkflowRunStatusEndedEvent object`
2825
2826 A workflow run ended. Emitted once per run, as the last of the run's `workflow_run.*` events.
2827
2828 - `type: "workflow_run.status_ended"`
2829
2830 - `id: string`
2831
2832 Unique identifier for this event.
2833
2834 - `processed_at: string`
2835
2836 Timestamp when this event was processed.
2837
2838 format: date-time
2839
2840 - `result: BetaManagedAgentsWorkflowRunResult`
2841
2842 How the run ended.
2843
2844 - `BetaManagedAgentsWorkflowRunResultCompleted object`
2845
2846 The run's plan, a program that the agent wrote, finished. This does not say whether the work succeeded.
2847
2848 - `type: "completed"`
2849
2850 - `BetaManagedAgentsWorkflowRunResultError object`
2851
2852 The run failed or reached its time limit.
2853
2854 - `type: "error"`
2855
2856 - `error: BetaManagedAgentsWorkflowRunError`
2857
2858 Why the run did not finish.
2859
2860 - `BetaManagedAgentsTimeoutWorkflowRunError object`
2861
2862 The run reached its time limit.
2863
2864 - `type: "timeout_error"`
2865
2866 - `message: string`
2867
2868 Short explanation written by the server. It never contains content from the run or its agents.
2869
2870 - `BetaManagedAgentsProgramWorkflowRunError object`
2871
2872 The plan, a program that the agent wrote, failed, or the server refused it.
2873
2874 - `type: "program_error"`
2875
2876 - `message: string`
2877
2878 Short explanation written by the server. It never contains content from the run or its agents.
2879
2880 - `BetaManagedAgentsUnknownWorkflowRunError object`
2881
2882 A failure that has no type of its own.
2883
2884 - `type: "unknown_error"`
2885
2886 - `message: string`
2887
2888 Short explanation written by the server. It never contains content from the run or its agents.
2889
2890 - `BetaManagedAgentsThreadLimitWorkflowRunError object`
2891
2892 The run exceeded the limit on the number of threads that a run can create.
2893
2894 - `type: "thread_limit_error"`
2895
2896 - `message: string`
2897
2898 Short explanation written by the server. It never contains content from the run or its agents.
2899
2900 - `BetaManagedAgentsMaxWorkflowRunsWorkflowRunError object`
2901
2902 No run was created, because the session was at its limit of open workflow runs, which are runs that have not ended. Only `workflow_run.error` carries this type.
2903
2904 - `type: "max_workflow_runs_error"`
2905
2906 - `message: string`
2907
2908 Short explanation written by the server. It never contains content from the run or its agents.
2909
2910 - `BetaManagedAgentsWorkflowRunResultStopped object`
2911
2912 The agent stopped the run.
2913
2914 - `type: "stopped"`
2915
2916 - `workflow_run_id: string`
2917
2918 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
2919
2920 - `BetaManagedAgentsWorkflowRunPhaseStartedEvent object`
2921
2922 A workflow run's plan entered a phase.
2923
2924 - `type: "workflow_run.phase_started"`
2925
2926 - `id: string`
2927
2928 Unique identifier for this event.
2929
2930 - `processed_at: string`
2931
2932 Timestamp when this event was processed.
2933
2934 format: date-time
2935
2936 - `workflow_run_id: string`
2937
2938 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
2939
2940 - `workflow_run_phase_id: string`
2941
2942 Identifier of the phase, as in `phases` on the run's `workflow_run.created` event.
2943
2944 - `BetaManagedAgentsWorkflowRunPhaseEndedEvent object`
2945
2946 A workflow run's plan left a phase, or the run's end closed it. Emitted once for every `workflow_run.phase_started` event, before the run's `workflow_run.status_ended` event. The event does not say whether the plan finished the phase's work, or why it left.
2947
2948 - `type: "workflow_run.phase_ended"`
2949
2950 - `id: string`
2951
2952 Unique identifier for this event.
2953
2954 - `phase_started_id: string`
2955
2956 Identifier of the `workflow_run.phase_started` event that opened the phase.
2957
2958 - `processed_at: string`
2959
2960 Timestamp when this event was processed.
2961
2962 format: date-time
2963
2964 - `workflow_run_id: string`
2965
2966 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
2967
2968 - `workflow_run_phase_id: string`
2969
2970 Identifier of the phase, as in `phases` on the run's `workflow_run.created` event.
2971
2972 - `BetaManagedAgentsWorkflowRunStatusRunningEvent object`
2973
2974 A workflow run is running. Emitted when the run starts to execute, and each time it resumes after being idle. A run that starts idle emits `workflow_run.status_idle` first.
2975
2976 - `type: "workflow_run.status_running"`
2977
2978 - `id: string`
2979
2980 Unique identifier for this event.
2981
2982 - `processed_at: string`
2983
2984 Timestamp when this event was processed.
2985
2986 format: date-time
2987
2988 - `workflow_run_id: string`
2989
2990 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
2991
2992 - `BetaManagedAgentsWorkflowRunStatusIdleEvent object`
2993
2994 A workflow run is idle. Emitted each time the run goes idle, whatever the cause. If the run ends while idle, no `workflow_run.status_running` comes between this event and its `workflow_run.status_ended`.
2995
2996 - `type: "workflow_run.status_idle"`
2997
2998 - `id: string`
2999
3000 Unique identifier for this event.
3001
3002 - `processed_at: string`
3003
3004 Timestamp when this event was processed.
3005
3006 format: date-time
3007
3008 - `workflow_run_id: string`
3009
3010 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
3011
3012 - `BetaManagedAgentsWorkflowRunErrorEvent object`
3013
3014 A workflow run met an error, or an error kept a run from being created. A run that ends with a `result.type` of `error` emits this event before its `workflow_run.status_ended`, with the same `error`.
3015
3016 - `type: "workflow_run.error"`
3017
3018 - `id: string`
3019
3020 Unique identifier for this event.
3021
3022 - `error: BetaManagedAgentsWorkflowRunError`
3023
3024 Why the run did not finish, or was not created.
3025
3026 - `processed_at: string`
3027
3028 Timestamp when this event was processed.
3029
3030 format: date-time
3031
3032 - `workflow_run_id: string or null`
3033
3034 Identifier of the run that met the error, or `null` when the error kept a run from being created.
26413035
26423036- `next_page: optional string or null`
26433037
26443038
No line in this hunk matches that.