List Events changedapi/beta/sessions/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+847added
Lines−439removed
From line
127
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits20to this page, all time
The whole hunk
from line 127, 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 127
127127
128128 - `"session.usage"`
129129
130 - `"workflow_run.created"`
131
132 - `"workflow_run.status_running"`
133
134 - `"workflow_run.status_idle"`
135
136 - `"workflow_run.status_ended"`
137
138 - `"workflow_run.error"`
139
140 - `"workflow_run.phase_started"`
141
142 - `"workflow_run.phase_ended"`
143
130144## Headers
131145
132146- `"anthropic-version": optional string`
from line 499
485499
486500 - `custom_tool_use_id: string`
487501
488 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.
502 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.
489503
490504 - `content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock`
491505
from line 571
557571
558572 - `BetaManagedAgentsAgentCustomToolUseEvent object`
559573
560 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.
574 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`.
561575
562576 - `type: "agent.custom_tool_use"`
563577
from line 1513
14991513
15001514 Public `sthr_` ID of the newly created thread.
15011515
1516 - `workflow_run_id: string or null`
1517
1518 Identifier of the workflow run that created the thread, or `null` for any other thread.
1519
15021520 - `BetaManagedAgentsSpanOutcomeEvaluationStartEvent object`
15031521
15041522 Emitted when an outcome evaluation cycle begins.
from line 2017
19992017
20002018 - `"claude-haiku-4-5"`
20012019
2002 Fastest model with near-frontier intelligence
2003
20042020 - `"claude-haiku-4-5-20251001"`
20052021
2006 Fastest model with near-frontier intelligence
2007
20082022 - `"claude-opus-4-5"`
20092023
20102024 Powerful intelligence for long-running agents and coding
from line 2087
20732087
20742088 - `"fast"`
20752089
2076 - `multiagent: BetaManagedAgentsSessionMultiagentCoordinator or null`
2090 - `multiagent: BetaManagedAgentsSessionMultiagent or null`
20772091
20782092 Resolved multiagent orchestration configuration. Null when the agent is single-threaded.
20792093
2080 - `type: "coordinator"`
2081
2082 - `agents: array of BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
2083
2084 Full `agent` definitions the coordinator may spawn as session threads.
2085
2086 - `BetaManagedAgentsSessionThreadAgent object`
2087
2088 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`.
2089
2090 - `type: "agent"`
2091
2092 - `id: string`
2093
2094 - `description: string or null`
2095
2096 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
2097
2098 - `type: "url"`
2094 - `BetaManagedAgentsSessionMultiagentCoordinator object`
2095
2096 Resolved coordinator topology with full agent definitions for each roster member.
2097
2098 - `type: "coordinator"`
2099
2100 - `agents: array of BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
2101
2102 Full `agent` definitions the coordinator may spawn as session threads.
2103
2104 - `BetaManagedAgentsSessionThreadAgent object`
2105
2106 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`.
2107
2108 - `type: "agent"`
2109
2110 - `id: string`
2111
2112 - `description: string or null`
2113
2114 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
2115
2116 - `type: "url"`
2117
2118 - `name: string`
2119
2120 - `url: string`
2121
2122 - `model: BetaManagedAgentsModelConfig`
2123
2124 Model identifier and configuration.
20992125
21002126 - `name: string`
21012127
2102 - `url: string`
2103
2104 - `model: BetaManagedAgentsModelConfig`
2105
2106 Model identifier and configuration.
2107
2108 - `name: string`
2109
2110 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
2111
2112 - `BetaManagedAgentsAnthropicSkill object`
2113
2114 A resolved Anthropic-managed skill.
2115
2116 - `type: "anthropic"`
2117
2118 - `skill_id: string`
2119
2120 - `version: string`
2121
2122 - `BetaManagedAgentsCustomSkill object`
2123
2124 A resolved user-created custom skill.
2125
2126 - `type: "custom"`
2127
2128 - `skill_id: string`
2129
2130 - `version: string`
2131
2132 - `system: string or null`
2133
2134 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
2135
2136 - `BetaManagedAgentsAgentToolset20260401 object`
2137
2138 - `type: "agent_toolset_20260401"`
2139
2140 - `configs: array of BetaManagedAgentsAgentToolConfig`
2141
2142 - `BetaManagedAgentsBashToolConfig object`
2143
2144 Configuration for the bash tool.
2145
2146 - `type: "bash"`
2128 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
2129
2130 - `BetaManagedAgentsAnthropicSkill object`
2131
2132 A resolved Anthropic-managed skill.
2133
2134 - `type: "anthropic"`
2135
2136 - `skill_id: string`
2137
2138 - `version: string`
2139
2140 - `BetaManagedAgentsCustomSkill object`
2141
2142 A resolved user-created custom skill.
2143
2144 - `type: "custom"`
2145
2146 - `skill_id: string`
2147
2148 - `version: string`
2149
2150 - `system: string or null`
2151
2152 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
2153
2154 - `BetaManagedAgentsAgentToolset20260401 object`
2155
2156 - `type: "agent_toolset_20260401"`
2157
2158 - `configs: array of BetaManagedAgentsAgentToolConfig`
2159
2160 - `BetaManagedAgentsBashToolConfig object`
2161
2162 Configuration for the bash tool.
2163
2164 - `type: "bash"`
2165
2166 - `enabled: boolean`
2167
2168 - `name: "bash"`
2169
2170 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2171
2172 Permission policy for tool execution.
2173
2174 - `BetaManagedAgentsAlwaysAllowPolicy object`
2175
2176 Tool calls are automatically approved without user confirmation.
2177
2178 - `type: "always_allow"`
2179
2180 - `BetaManagedAgentsAlwaysAskPolicy object`
2181
2182 Tool calls require user confirmation before execution.
2183
2184 - `type: "always_ask"`
2185
2186 - `BetaManagedAgentsAutoPolicy object`
2187
2188 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.
2189
2190 - `type: "auto"`
2191
2192 - `BetaManagedAgentsEditToolConfig object`
2193
2194 Configuration for the edit tool.
2195
2196 - `type: "edit"`
2197
2198 - `enabled: boolean`
2199
2200 - `name: "edit"`
2201
2202 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2203
2204 Permission policy for tool execution.
2205
2206 - `BetaManagedAgentsAlwaysAllowPolicy object`
2207
2208 Tool calls are automatically approved without user confirmation.
2209
2210 - `BetaManagedAgentsAlwaysAskPolicy object`
2211
2212 Tool calls require user confirmation before execution.
2213
2214 - `BetaManagedAgentsAutoPolicy object`
2215
2216 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.
2217
2218 - `BetaManagedAgentsReadToolConfig object`
2219
2220 Configuration for the read tool.
2221
2222 - `type: "read"`
2223
2224 - `enabled: boolean`
2225
2226 - `name: "read"`
2227
2228 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2229
2230 Permission policy for tool execution.
2231
2232 - `BetaManagedAgentsAlwaysAllowPolicy object`
2233
2234 Tool calls are automatically approved without user confirmation.
2235
2236 - `BetaManagedAgentsAlwaysAskPolicy object`
2237
2238 Tool calls require user confirmation before execution.
2239
2240 - `BetaManagedAgentsAutoPolicy object`
2241
2242 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.
2243
2244 - `BetaManagedAgentsWriteToolConfig object`
2245
2246 Configuration for the write tool.
2247
2248 - `type: "write"`
2249
2250 - `enabled: boolean`
2251
2252 - `name: "write"`
2253
2254 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2255
2256 Permission policy for tool execution.
2257
2258 - `BetaManagedAgentsAlwaysAllowPolicy object`
2259
2260 Tool calls are automatically approved without user confirmation.
2261
2262 - `BetaManagedAgentsAlwaysAskPolicy object`
2263
2264 Tool calls require user confirmation before execution.
2265
2266 - `BetaManagedAgentsAutoPolicy object`
2267
2268 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.
2269
2270 - `BetaManagedAgentsGlobToolConfig object`
2271
2272 Configuration for the glob tool.
2273
2274 - `type: "glob"`
2275
2276 - `enabled: boolean`
2277
2278 - `name: "glob"`
2279
2280 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2281
2282 Permission policy for tool execution.
2283
2284 - `BetaManagedAgentsAlwaysAllowPolicy object`
2285
2286 Tool calls are automatically approved without user confirmation.
2287
2288 - `BetaManagedAgentsAlwaysAskPolicy object`
2289
2290 Tool calls require user confirmation before execution.
2291
2292 - `BetaManagedAgentsAutoPolicy object`
2293
2294 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.
2295
2296 - `BetaManagedAgentsGrepToolConfig object`
2297
2298 Configuration for the grep tool.
2299
2300 - `type: "grep"`
2301
2302 - `enabled: boolean`
2303
2304 - `name: "grep"`
2305
2306 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2307
2308 Permission policy for tool execution.
2309
2310 - `BetaManagedAgentsAlwaysAllowPolicy object`
2311
2312 Tool calls are automatically approved without user confirmation.
2313
2314 - `BetaManagedAgentsAlwaysAskPolicy object`
2315
2316 Tool calls require user confirmation before execution.
2317
2318 - `BetaManagedAgentsAutoPolicy object`
2319
2320 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.
2321
2322 - `BetaManagedAgentsWebFetchToolConfig object`
2323
2324 Configuration for the web_fetch tool.
2325
2326 - `type: "web_fetch"`
2327
2328 - `enabled: boolean`
2329
2330 - `name: "web_fetch"`
2331
2332 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2333
2334 Permission policy for tool execution.
2335
2336 - `BetaManagedAgentsAlwaysAllowPolicy object`
2337
2338 Tool calls are automatically approved without user confirmation.
2339
2340 - `BetaManagedAgentsAlwaysAskPolicy object`
2341
2342 Tool calls require user confirmation before execution.
2343
2344 - `BetaManagedAgentsAutoPolicy object`
2345
2346 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.
2347
2348 - `url_sources: BetaManagedAgentsWebFetchURLSources or null`
2349
2350 Which sources contribute URLs the tool may fetch, always in the object form. Null when not set, which allows every source.
2351
2352 - `client_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
2353
2354 Which custom tools' results contribute URLs that may be fetched. Null when not set, which allows every custom tool's results.
2355
2356 - `BetaManagedAgentsWebFetchURLSourceAll object`
2357
2358 Every URL from this source may be fetched. This is the default.
2359
2360 - `type: "all"`
2361
2362 - `BetaManagedAgentsWebFetchURLSourceNone object`
2363
2364 This source contributes no URLs that may be fetched.
2365
2366 - `type: "none"`
2367
2368 - `BetaManagedAgentsWebFetchURLSourceOnly object`
2369
2370 Only the named tools' results contribute URLs that may be fetched.
2371
2372 - `type: "only"`
2373
2374 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
2375
2376 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.
2377
2378 - `type: "tool_reference"`
2379
2380 Must be "tool_reference".
2381
2382 - `name: string`
2383
2384 Name of the tool. Compared exactly, so upper and lower case letters are different.
2385
2386 minLength: 1, maxLength: 128
2387
2388 - `BetaManagedAgentsWebFetchURLSourceExcept object`
2389
2390 Every tool's results contribute URLs that may be fetched, except the named tools' results.
2391
2392 - `type: "except"`
2393
2394 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
2395
2396 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.
2397
2398 - `type: "tool_reference"`
2399
2400 Must be "tool_reference".
2401
2402 - `name: string`
2403
2404 Name of the tool. Compared exactly, so upper and lower case letters are different.
2405
2406 minLength: 1, maxLength: 128
2407
2408 - `server_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
2409
2410 Which of the web_search and web_fetch tools' results contribute URLs that may be fetched. Null when not set, which allows both.
2411
2412 - `user_input: BetaManagedAgentsWebFetchURLSourceUserInput or null`
2413
2414 Whether URLs in the text of user messages may be fetched. Null when not set, which allows them.
2415
2416 - `BetaManagedAgentsWebFetchURLSourceAll object`
2417
2418 Every URL from this source may be fetched. This is the default.
2419
2420 - `BetaManagedAgentsWebFetchURLSourceNone object`
2421
2422 This source contributes no URLs that may be fetched.
2423
2424 - `allowed_domains: optional array of string`
2425
2426 - `blocked_domains: optional array of string`
2427
2428 - `max_content_tokens: optional number or null`
2429
2430 format: int32
2431
2432 - `BetaManagedAgentsWebSearchToolConfig object`
2433
2434 Configuration for the web_search tool.
2435
2436 - `type: "web_search"`
2437
2438 - `enabled: boolean`
2439
2440 - `name: "web_search"`
2441
2442 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2443
2444 Permission policy for tool execution.
2445
2446 - `BetaManagedAgentsAlwaysAllowPolicy object`
2447
2448 Tool calls are automatically approved without user confirmation.
2449
2450 - `BetaManagedAgentsAlwaysAskPolicy object`
2451
2452 Tool calls require user confirmation before execution.
2453
2454 - `BetaManagedAgentsAutoPolicy object`
2455
2456 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.
2457
2458 - `allowed_domains: optional array of string`
2459
2460 - `blocked_domains: optional array of string`
2461
2462 - `user_location: optional BetaManagedAgentsUserLocation or null`
2463
2464 Approximate user location for search result localization.
2465
2466 - `type: "approximate"`
2467
2468 Location precision. Only "approximate" is supported.
2469
2470 - `city: optional string or null`
2471
2472 City name.
2473
2474 minLength: 1, maxLength: 255
2475
2476 - `country: optional string or null`
2477
2478 Two-letter ISO 3166-1 country code, uppercase.
2479
2480 - `region: optional string or null`
2481
2482 Region or state name.
2483
2484 minLength: 1, maxLength: 255
2485
2486 - `timezone: optional string or null`
2487
2488 IANA timezone identifier, e.g. "America/Los_Angeles".
2489
2490 minLength: 1, maxLength: 255
2491
2492 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
2493
2494 Resolved default configuration for agent tools.
21472495
21482496 - `enabled: boolean`
21492497
2150 - `name: "bash"`
2151
21522498 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
21532499
21542500 Permission policy for tool execution.
from line 2503
21572503
21582504 Tool calls are automatically approved without user confirmation.
21592505
2160 - `type: "always_allow"`
2161
21622506 - `BetaManagedAgentsAlwaysAskPolicy object`
21632507
21642508 Tool calls require user confirmation before execution.
21652509
2166 - `type: "always_ask"`
2167
21682510 - `BetaManagedAgentsAutoPolicy object`
21692511
21702512 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.
21712513
2172 - `type: "auto"`
2173
2174 - `BetaManagedAgentsEditToolConfig object`
2175
2176 Configuration for the edit tool.
2177
2178 - `type: "edit"`
2514 - `BetaManagedAgentsMCPToolset object`
2515
2516 - `type: "mcp_toolset"`
2517
2518 - `configs: array of BetaManagedAgentsMCPToolConfig`
21792519
21802520 - `enabled: boolean`
21812521
2182 - `name: "edit"`
2522 - `name: string`
21832523
21842524 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
21852525
from line 2537
21972537
21982538 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.
21992539
2200 - `BetaManagedAgentsReadToolConfig object`
2201
2202 Configuration for the read tool.
2203
2204 - `type: "read"`
2540 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
2541
2542 Resolved default configuration for all tools from an MCP server.
22052543
22062544 - `enabled: boolean`
22072545
2208 - `name: "read"`
2209
22102546 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
22112547
22122548 Permission policy for tool execution.
from line 2559
22232559
22242560 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.
22252561
2226 - `BetaManagedAgentsWriteToolConfig object`
2227
2228 Configuration for the write tool.
2229
2230 - `type: "write"`
2231
2232 - `enabled: boolean`
2233
2234 - `name: "write"`
2235
2236 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2237
2238 Permission policy for tool execution.
2239
2240 - `BetaManagedAgentsAlwaysAllowPolicy object`
2241
2242 Tool calls are automatically approved without user confirmation.
2243
2244 - `BetaManagedAgentsAlwaysAskPolicy object`
2245
2246 Tool calls require user confirmation before execution.
2247
2248 - `BetaManagedAgentsAutoPolicy object`
2249
2250 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.
2251
2252 - `BetaManagedAgentsGlobToolConfig object`
2253
2254 Configuration for the glob tool.
2255
2256 - `type: "glob"`
2257
2258 - `enabled: boolean`
2259
2260 - `name: "glob"`
2261
2262 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2263
2264 Permission policy for tool execution.
2265
2266 - `BetaManagedAgentsAlwaysAllowPolicy object`
2267
2268 Tool calls are automatically approved without user confirmation.
2269
2270 - `BetaManagedAgentsAlwaysAskPolicy object`
2271
2272 Tool calls require user confirmation before execution.
2273
2274 - `BetaManagedAgentsAutoPolicy object`
2275
2276 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.
2277
2278 - `BetaManagedAgentsGrepToolConfig object`
2279
2280 Configuration for the grep tool.
2281
2282 - `type: "grep"`
2283
2284 - `enabled: boolean`
2285
2286 - `name: "grep"`
2287
2288 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2289
2290 Permission policy for tool execution.
2291
2292 - `BetaManagedAgentsAlwaysAllowPolicy object`
2293
2294 Tool calls are automatically approved without user confirmation.
2295
2296 - `BetaManagedAgentsAlwaysAskPolicy object`
2297
2298 Tool calls require user confirmation before execution.
2299
2300 - `BetaManagedAgentsAutoPolicy object`
2301
2302 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.
2303
2304 - `BetaManagedAgentsWebFetchToolConfig object`
2305
2306 Configuration for the web_fetch tool.
2307
2308 - `type: "web_fetch"`
2309
2310 - `enabled: boolean`
2311
2312 - `name: "web_fetch"`
2313
2314 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2315
2316 Permission policy for tool execution.
2317
2318 - `BetaManagedAgentsAlwaysAllowPolicy object`
2319
2320 Tool calls are automatically approved without user confirmation.
2321
2322 - `BetaManagedAgentsAlwaysAskPolicy object`
2323
2324 Tool calls require user confirmation before execution.
2325
2326 - `BetaManagedAgentsAutoPolicy object`
2327
2328 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.
2329
2330 - `url_sources: BetaManagedAgentsWebFetchURLSources or null`
2331
2332 Which sources contribute URLs the tool may fetch, always in the object form. Null when not set, which allows every source.
2333
2334 - `client_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
2335
2336 Which custom tools' results contribute URLs that may be fetched. Null when not set, which allows every custom tool's results.
2337
2338 - `BetaManagedAgentsWebFetchURLSourceAll object`
2339
2340 Every URL from this source may be fetched. This is the default.
2341
2342 - `type: "all"`
2343
2344 - `BetaManagedAgentsWebFetchURLSourceNone object`
2345
2346 This source contributes no URLs that may be fetched.
2347
2348 - `type: "none"`
2349
2350 - `BetaManagedAgentsWebFetchURLSourceOnly object`
2351
2352 Only the named tools' results contribute URLs that may be fetched.
2353
2354 - `type: "only"`
2355
2356 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
2357
2358 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.
2359
2360 - `type: "tool_reference"`
2361
2362 Must be "tool_reference".
2363
2364 - `name: string`
2365
2366 Name of the tool. Compared exactly, so upper and lower case letters are different.
2367
2368 minLength: 1, maxLength: 128
2369
2370 - `BetaManagedAgentsWebFetchURLSourceExcept object`
2371
2372 Every tool's results contribute URLs that may be fetched, except the named tools' results.
2373
2374 - `type: "except"`
2375
2376 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
2377
2378 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.
2379
2380 - `type: "tool_reference"`
2381
2382 Must be "tool_reference".
2383
2384 - `name: string`
2385
2386 Name of the tool. Compared exactly, so upper and lower case letters are different.
2387
2388 minLength: 1, maxLength: 128
2389
2390 - `server_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
2391
2392 Which of the web_search and web_fetch tools' results contribute URLs that may be fetched. Null when not set, which allows both.
2393
2394 - `user_input: BetaManagedAgentsWebFetchURLSourceUserInput or null`
2395
2396 Whether URLs in the text of user messages may be fetched. Null when not set, which allows them.
2397
2398 - `BetaManagedAgentsWebFetchURLSourceAll object`
2399
2400 Every URL from this source may be fetched. This is the default.
2401
2402 - `BetaManagedAgentsWebFetchURLSourceNone object`
2403
2404 This source contributes no URLs that may be fetched.
2405
2406 - `allowed_domains: optional array of string`
2407
2408 - `blocked_domains: optional array of string`
2409
2410 - `max_content_tokens: optional number or null`
2411
2412 format: int32
2413
2414 - `BetaManagedAgentsWebSearchToolConfig object`
2415
2416 Configuration for the web_search tool.
2417
2418 - `type: "web_search"`
2419
2420 - `enabled: boolean`
2421
2422 - `name: "web_search"`
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 - `allowed_domains: optional array of string`
2441
2442 - `blocked_domains: optional array of string`
2443
2444 - `user_location: optional BetaManagedAgentsUserLocation or null`
2445
2446 Approximate user location for search result localization.
2447
2448 - `type: "approximate"`
2449
2450 Location precision. Only "approximate" is supported.
2451
2452 - `city: optional string or null`
2453
2454 City name.
2455
2456 minLength: 1, maxLength: 255
2457
2458 - `country: optional string or null`
2459
2460 Two-letter ISO 3166-1 country code, uppercase.
2461
2462 - `region: optional string or null`
2463
2464 Region or state name.
2465
2466 minLength: 1, maxLength: 255
2467
2468 - `timezone: optional string or null`
2469
2470 IANA timezone identifier, e.g. "America/Los_Angeles".
2471
2472 minLength: 1, maxLength: 255
2473
2474 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
2475
2476 Resolved default configuration for agent tools.
2477
2478 - `enabled: boolean`
2479
2480 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2481
2482 Permission policy for tool execution.
2483
2484 - `BetaManagedAgentsAlwaysAllowPolicy object`
2485
2486 Tool calls are automatically approved without user confirmation.
2487
2488 - `BetaManagedAgentsAlwaysAskPolicy object`
2489
2490 Tool calls require user confirmation before execution.
2491
2492 - `BetaManagedAgentsAutoPolicy object`
2493
2494 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.
2495
2496 - `BetaManagedAgentsMCPToolset object`
2497
2498 - `type: "mcp_toolset"`
2499
2500 - `configs: array of BetaManagedAgentsMCPToolConfig`
2501
2502 - `enabled: boolean`
2562 - `mcp_server_name: string`
2563
2564 - `BetaManagedAgentsCustomTool object`
2565
2566 A custom tool as returned in API responses.
2567
2568 - `type: "custom"`
2569
2570 - `description: string`
2571
2572 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
2573
2574 JSON Schema for custom tool input parameters.
2575
2576 - `type: "object"`
2577
2578 - `properties: optional map[unknown] or null`
2579
2580 - `required: optional array of string or null`
25032581
25042582 - `name: string`
25052583
2506 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2507
2508 Permission policy for tool execution.
2509
2510 - `BetaManagedAgentsAlwaysAllowPolicy object`
2511
2512 Tool calls are automatically approved without user confirmation.
2513
2514 - `BetaManagedAgentsAlwaysAskPolicy object`
2515
2516 Tool calls require user confirmation before execution.
2517
2518 - `BetaManagedAgentsAutoPolicy object`
2519
2520 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.
2521
2522 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
2523
2524 Resolved default configuration for all tools from an MCP server.
2525
2526 - `enabled: boolean`
2527
2528 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2529
2530 Permission policy for tool execution.
2531
2532 - `BetaManagedAgentsAlwaysAllowPolicy object`
2533
2534 Tool calls are automatically approved without user confirmation.
2535
2536 - `BetaManagedAgentsAlwaysAskPolicy object`
2537
2538 Tool calls require user confirmation before execution.
2539
2540 - `BetaManagedAgentsAutoPolicy object`
2541
2542 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.
2543
2544 - `mcp_server_name: string`
2545
2546 - `BetaManagedAgentsCustomTool object`
2547
2548 A custom tool as returned in API responses.
2549
2550 - `type: "custom"`
2551
2552 - `description: string`
2553
2554 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
2555
2556 JSON Schema for custom tool input parameters.
2557
2558 - `type: "object"`
2559
2560 - `properties: optional map[unknown] or null`
2561
2562 - `required: optional array of string or null`
2584 - `version: number`
2585
2586 format: int32
2587
2588 - `BetaManagedAgentsAdvisor object`
2589
2590 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
2591
2592 - `type: "advisor"`
2593
2594 - `model: string`
2595
2596 The advisor model id.
2597
2598 - `BetaManagedAgentsSessionMultiagent20261001 object`
2599
2600 Resolved multiagent configuration with three members, as copied to the `session` at creation.
2601
2602 - `type: "multiagent_20261001"`
2603
2604 - `advisor: BetaManagedAgentsMultiagentAdvisor`
2605
2606 Whether the session's primary thread can consult an advisor model.
2607
2608 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
2609
2610 The session's primary thread can consult `model` mid-turn.
2611
2612 - `type: "enabled"`
2613
2614 - `model: string`
2615
2616 The advisor model id.
2617
2618 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
2619
2620 The agent has no advisor.
2621
2622 - `type: "disabled"`
2623
2624 - `subagents: BetaManagedAgentsSessionMultiagentSubagents`
2625
2626 Whether the agent can spawn session threads.
2627
2628 - `BetaManagedAgentsSessionMultiagentSubagentsEnabled object`
2629
2630 The agent can spawn session threads.
2631
2632 - `type: "enabled"`
2633
2634 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
2635
2636 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
2637
2638 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
2639
2640 The agent can define inline agents.
2641
2642 - `type: "enabled"`
2643
2644 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
2645
2646 The agent cannot define inline agents.
2647
2648 - `type: "disabled"`
2649
2650 - `predefined_agents: array of BetaManagedAgentsSessionThreadAgent`
2651
2652 Full `agent` definitions of the predefined agents, which are saved agents that this agent can spawn as session threads.
2653
2654 - `type: "agent"`
2655
2656 - `id: string`
2657
2658 - `description: string or null`
2659
2660 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
2661
2662 - `model: BetaManagedAgentsModelConfig`
2663
2664 Model identifier and configuration.
25632665
25642666 - `name: string`
25652667
2566 - `version: number`
2567
2568 format: int32
2569
2570 - `BetaManagedAgentsAdvisor object`
2571
2572 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
2573
2574 - `type: "advisor"`
2575
2576 - `model: string`
2577
2578 The advisor model id.
2668 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
2669
2670 - `system: string or null`
2671
2672 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
2673
2674 - `version: number`
2675
2676 format: int32
2677
2678 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
2679
2680 The agent cannot spawn session threads.
2681
2682 - `type: "disabled"`
2683
2684 - `workflows: BetaManagedAgentsSessionMultiagentWorkflows`
2685
2686 Whether the agent can start workflow runs.
2687
2688 - `BetaManagedAgentsSessionMultiagentWorkflowsEnabled object`
2689
2690 The agent can start workflow runs.
2691
2692 - `type: "enabled"`
2693
2694 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
2695
2696 Whether a run's plan can define inline agents, which are not saved.
2697
2698 - `predefined_agents: array of BetaManagedAgentsSessionThreadAgent`
2699
2700 Full `agent` definitions of the predefined agents, which are saved agents that a run's plan can use.
2701
2702 - `type: "agent"`
2703
2704 - `id: string`
2705
2706 - `description: string or null`
2707
2708 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
2709
2710 - `model: BetaManagedAgentsModelConfig`
2711
2712 Model identifier and configuration.
2713
2714 - `name: string`
2715
2716 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
2717
2718 - `system: string or null`
2719
2720 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
2721
2722 - `version: number`
2723
2724 format: int32
2725
2726 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
2727
2728 The agent cannot start workflow runs.
2729
2730 - `type: "disabled"`
25792731
25802732 - `name: string`
25812733
from line 2894
27422894 - `budget: optional BetaManagedAgentsBudgetLimit or null`
27432895
27442896 The session's configured budget at the snapshot time, or null when the session has no budget.
2897
2898 - `BetaManagedAgentsWorkflowRunCreatedEvent object`
2899
2900 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.
2901
2902 - `type: "workflow_run.created"`
2903
2904 - `id: string`
2905
2906 Unique identifier for this event.
2907
2908 - `description: string or null`
2909
2910 Description that the agent gave the run, passed on as written, or `null` if it gave none.
2911
2912 - `name: string`
2913
2914 Name that the agent gave the run, passed on as written, or a name that the server assigned.
2915
2916 - `phases: array of BetaManagedAgentsWorkflowRunPhase`
2917
2918 The phases that the run's plan declares, in the plan's order. Can be empty.
2919
2920 - `id: string`
2921
2922 Unique identifier for the phase.
2923
2924 - `description: string or null`
2925
2926 Description that the agent gave the phase, passed on as written, or `null` if it gave none.
2927
2928 - `name: string`
2929
2930 Name that the agent gave the phase, passed on as written.
2931
2932 - `processed_at: string`
2933
2934 Timestamp when this event was processed.
2935
2936 format: date-time
2937
2938 - `workflow_run_id: string`
2939
2940 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
2941
2942 - `BetaManagedAgentsWorkflowRunStatusEndedEvent object`
2943
2944 A workflow run ended. Emitted once per run, as the last of the run's `workflow_run.*` events.
2945
2946 - `type: "workflow_run.status_ended"`
2947
2948 - `id: string`
2949
2950 Unique identifier for this event.
2951
2952 - `processed_at: string`
2953
2954 Timestamp when this event was processed.
2955
2956 format: date-time
2957
2958 - `result: BetaManagedAgentsWorkflowRunResult`
2959
2960 How the run ended.
2961
2962 - `BetaManagedAgentsWorkflowRunResultCompleted object`
2963
2964 The run's plan, a program that the agent wrote, finished. This does not say whether the work succeeded.
2965
2966 - `type: "completed"`
2967
2968 - `BetaManagedAgentsWorkflowRunResultError object`
2969
2970 The run failed or reached its time limit.
2971
2972 - `type: "error"`
2973
2974 - `error: BetaManagedAgentsWorkflowRunError`
2975
2976 Why the run did not finish.
2977
2978 - `BetaManagedAgentsTimeoutWorkflowRunError object`
2979
2980 The run reached its time limit.
2981
2982 - `type: "timeout_error"`
2983
2984 - `message: string`
2985
2986 Short explanation written by the server. It never contains content from the run or its agents.
2987
2988 - `BetaManagedAgentsProgramWorkflowRunError object`
2989
2990 The plan, a program that the agent wrote, failed, or the server refused it.
2991
2992 - `type: "program_error"`
2993
2994 - `message: string`
2995
2996 Short explanation written by the server. It never contains content from the run or its agents.
2997
2998 - `BetaManagedAgentsUnknownWorkflowRunError object`
2999
3000 A failure that has no type of its own.
3001
3002 - `type: "unknown_error"`
3003
3004 - `message: string`
3005
3006 Short explanation written by the server. It never contains content from the run or its agents.
3007
3008 - `BetaManagedAgentsThreadLimitWorkflowRunError object`
3009
3010 The run exceeded the limit on the number of threads that a run can create.
3011
3012 - `type: "thread_limit_error"`
3013
3014 - `message: string`
3015
3016 Short explanation written by the server. It never contains content from the run or its agents.
3017
3018 - `BetaManagedAgentsMaxWorkflowRunsWorkflowRunError object`
3019
3020 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.
3021
3022 - `type: "max_workflow_runs_error"`
3023
3024 - `message: string`
3025
3026 Short explanation written by the server. It never contains content from the run or its agents.
3027
3028 - `BetaManagedAgentsWorkflowRunResultStopped object`
3029
3030 The agent stopped the run.
3031
3032 - `type: "stopped"`
3033
3034 - `workflow_run_id: string`
3035
3036 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
3037
3038 - `BetaManagedAgentsWorkflowRunPhaseStartedEvent object`
3039
3040 A workflow run's plan entered a phase.
3041
3042 - `type: "workflow_run.phase_started"`
3043
3044 - `id: string`
3045
3046 Unique identifier for this event.
3047
3048 - `processed_at: string`
3049
3050 Timestamp when this event was processed.
3051
3052 format: date-time
3053
3054 - `workflow_run_id: string`
3055
3056 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
3057
3058 - `workflow_run_phase_id: string`
3059
3060 Identifier of the phase, as in `phases` on the run's `workflow_run.created` event.
3061
3062 - `BetaManagedAgentsWorkflowRunPhaseEndedEvent object`
3063
3064 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.
3065
3066 - `type: "workflow_run.phase_ended"`
3067
3068 - `id: string`
3069
3070 Unique identifier for this event.
3071
3072 - `phase_started_id: string`
3073
3074 Identifier of the `workflow_run.phase_started` event that opened the phase.
3075
3076 - `processed_at: string`
3077
3078 Timestamp when this event was processed.
3079
3080 format: date-time
3081
3082 - `workflow_run_id: string`
3083
3084 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
3085
3086 - `workflow_run_phase_id: string`
3087
3088 Identifier of the phase, as in `phases` on the run's `workflow_run.created` event.
3089
3090 - `BetaManagedAgentsWorkflowRunStatusRunningEvent object`
3091
3092 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.
3093
3094 - `type: "workflow_run.status_running"`
3095
3096 - `id: string`
3097
3098 Unique identifier for this event.
3099
3100 - `processed_at: string`
3101
3102 Timestamp when this event was processed.
3103
3104 format: date-time
3105
3106 - `workflow_run_id: string`
3107
3108 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
3109
3110 - `BetaManagedAgentsWorkflowRunStatusIdleEvent object`
3111
3112 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`.
3113
3114 - `type: "workflow_run.status_idle"`
3115
3116 - `id: string`
3117
3118 Unique identifier for this event.
3119
3120 - `processed_at: string`
3121
3122 Timestamp when this event was processed.
3123
3124 format: date-time
3125
3126 - `workflow_run_id: string`
3127
3128 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
3129
3130 - `BetaManagedAgentsWorkflowRunErrorEvent object`
3131
3132 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`.
3133
3134 - `type: "workflow_run.error"`
3135
3136 - `id: string`
3137
3138 Unique identifier for this event.
3139
3140 - `error: BetaManagedAgentsWorkflowRunError`
3141
3142 Why the run did not finish, or was not created.
3143
3144 - `processed_at: string`
3145
3146 Timestamp when this event was processed.
3147
3148 format: date-time
3149
3150 - `workflow_run_id: string or null`
3151
3152 Identifier of the run that met the error, or `null` when the error kept a run from being created.
27453153
27463154- `next_page: optional string or null`
27473155
27483156
No line in this hunk matches that.