Stream Session Thread Events changedapi/beta/sessions/threads/events/stream
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+834added
Lines−440removed
From line
143
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 143, 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 143
143143
144144## Returns
145145
146- `BetaManagedAgentsStreamSessionThreadEvents = BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 34 more`
146- `BetaManagedAgentsStreamSessionThreadEvents = BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 41 more`
147147
148148 Server-sent event in a single thread's stream.
149149
from line 383
383383
384384 - `custom_tool_use_id: string`
385385
386 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.
386 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.
387387
388388 - `content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock`
389389
from line 455
455455
456456 - `BetaManagedAgentsAgentCustomToolUseEvent object`
457457
458 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.
458 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`.
459459
460460 - `type: "agent.custom_tool_use"`
461461
from line 1397
13971397
13981398 Public `sthr_` ID of the newly created thread.
13991399
1400 - `workflow_run_id: string or null`
1401
1402 Identifier of the workflow run that created the thread, or `null` for any other thread.
1403
14001404 - `BetaManagedAgentsSpanOutcomeEvaluationStartEvent object`
14011405
14021406 Emitted when an outcome evaluation cycle begins.
from line 1901
18971901
18981902 - `"claude-haiku-4-5"`
18991903
1900 Fastest model with near-frontier intelligence
1901
19021904 - `"claude-haiku-4-5-20251001"`
19031905
1904 Fastest model with near-frontier intelligence
1905
19061906 - `"claude-opus-4-5"`
19071907
19081908 Powerful intelligence for long-running agents and coding
from line 1971
19711971
19721972 - `"fast"`
19731973
1974 - `multiagent: BetaManagedAgentsSessionMultiagentCoordinator or null`
1974 - `multiagent: BetaManagedAgentsSessionMultiagent or null`
19751975
19761976 Resolved multiagent orchestration configuration. Null when the agent is single-threaded.
19771977
1978 - `type: "coordinator"`
1979
1980 - `agents: array of BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
1981
1982 Full `agent` definitions the coordinator may spawn as session threads.
1983
1984 - `BetaManagedAgentsSessionThreadAgent object`
1985
1986 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`.
1987
1988 - `type: "agent"`
1989
1990 - `id: string`
1991
1992 - `description: string or null`
1993
1994 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
1995
1996 - `type: "url"`
1978 - `BetaManagedAgentsSessionMultiagentCoordinator object`
1979
1980 Resolved coordinator topology with full agent definitions for each roster member.
1981
1982 - `type: "coordinator"`
1983
1984 - `agents: array of BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
1985
1986 Full `agent` definitions the coordinator may spawn as session threads.
1987
1988 - `BetaManagedAgentsSessionThreadAgent object`
1989
1990 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`.
1991
1992 - `type: "agent"`
1993
1994 - `id: string`
1995
1996 - `description: string or null`
1997
1998 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
1999
2000 - `type: "url"`
2001
2002 - `name: string`
2003
2004 - `url: string`
2005
2006 - `model: BetaManagedAgentsModelConfig`
2007
2008 Model identifier and configuration.
19972009
19982010 - `name: string`
19992011
2000 - `url: string`
2001
2002 - `model: BetaManagedAgentsModelConfig`
2003
2004 Model identifier and configuration.
2005
2006 - `name: string`
2007
2008 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
2009
2010 - `BetaManagedAgentsAnthropicSkill object`
2011
2012 A resolved Anthropic-managed skill.
2013
2014 - `type: "anthropic"`
2015
2016 - `skill_id: string`
2017
2018 - `version: string`
2019
2020 - `BetaManagedAgentsCustomSkill object`
2021
2022 A resolved user-created custom skill.
2023
2024 - `type: "custom"`
2025
2026 - `skill_id: string`
2027
2028 - `version: string`
2029
2030 - `system: string or null`
2031
2032 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
2033
2034 - `BetaManagedAgentsAgentToolset20260401 object`
2035
2036 - `type: "agent_toolset_20260401"`
2037
2038 - `configs: array of BetaManagedAgentsAgentToolConfig`
2039
2040 - `BetaManagedAgentsBashToolConfig object`
2041
2042 Configuration for the bash tool.
2043
2044 - `type: "bash"`
2012 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
2013
2014 - `BetaManagedAgentsAnthropicSkill object`
2015
2016 A resolved Anthropic-managed skill.
2017
2018 - `type: "anthropic"`
2019
2020 - `skill_id: string`
2021
2022 - `version: string`
2023
2024 - `BetaManagedAgentsCustomSkill object`
2025
2026 A resolved user-created custom skill.
2027
2028 - `type: "custom"`
2029
2030 - `skill_id: string`
2031
2032 - `version: string`
2033
2034 - `system: string or null`
2035
2036 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
2037
2038 - `BetaManagedAgentsAgentToolset20260401 object`
2039
2040 - `type: "agent_toolset_20260401"`
2041
2042 - `configs: array of BetaManagedAgentsAgentToolConfig`
2043
2044 - `BetaManagedAgentsBashToolConfig object`
2045
2046 Configuration for the bash tool.
2047
2048 - `type: "bash"`
2049
2050 - `enabled: boolean`
2051
2052 - `name: "bash"`
2053
2054 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2055
2056 Permission policy for tool execution.
2057
2058 - `BetaManagedAgentsAlwaysAllowPolicy object`
2059
2060 Tool calls are automatically approved without user confirmation.
2061
2062 - `type: "always_allow"`
2063
2064 - `BetaManagedAgentsAlwaysAskPolicy object`
2065
2066 Tool calls require user confirmation before execution.
2067
2068 - `type: "always_ask"`
2069
2070 - `BetaManagedAgentsAutoPolicy object`
2071
2072 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.
2073
2074 - `type: "auto"`
2075
2076 - `BetaManagedAgentsEditToolConfig object`
2077
2078 Configuration for the edit tool.
2079
2080 - `type: "edit"`
2081
2082 - `enabled: boolean`
2083
2084 - `name: "edit"`
2085
2086 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2087
2088 Permission policy for tool execution.
2089
2090 - `BetaManagedAgentsAlwaysAllowPolicy object`
2091
2092 Tool calls are automatically approved without user confirmation.
2093
2094 - `BetaManagedAgentsAlwaysAskPolicy object`
2095
2096 Tool calls require user confirmation before execution.
2097
2098 - `BetaManagedAgentsAutoPolicy object`
2099
2100 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.
2101
2102 - `BetaManagedAgentsReadToolConfig object`
2103
2104 Configuration for the read tool.
2105
2106 - `type: "read"`
2107
2108 - `enabled: boolean`
2109
2110 - `name: "read"`
2111
2112 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2113
2114 Permission policy for tool execution.
2115
2116 - `BetaManagedAgentsAlwaysAllowPolicy object`
2117
2118 Tool calls are automatically approved without user confirmation.
2119
2120 - `BetaManagedAgentsAlwaysAskPolicy object`
2121
2122 Tool calls require user confirmation before execution.
2123
2124 - `BetaManagedAgentsAutoPolicy object`
2125
2126 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.
2127
2128 - `BetaManagedAgentsWriteToolConfig object`
2129
2130 Configuration for the write tool.
2131
2132 - `type: "write"`
2133
2134 - `enabled: boolean`
2135
2136 - `name: "write"`
2137
2138 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2139
2140 Permission policy for tool execution.
2141
2142 - `BetaManagedAgentsAlwaysAllowPolicy object`
2143
2144 Tool calls are automatically approved without user confirmation.
2145
2146 - `BetaManagedAgentsAlwaysAskPolicy object`
2147
2148 Tool calls require user confirmation before execution.
2149
2150 - `BetaManagedAgentsAutoPolicy object`
2151
2152 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.
2153
2154 - `BetaManagedAgentsGlobToolConfig object`
2155
2156 Configuration for the glob tool.
2157
2158 - `type: "glob"`
2159
2160 - `enabled: boolean`
2161
2162 - `name: "glob"`
2163
2164 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2165
2166 Permission policy for tool execution.
2167
2168 - `BetaManagedAgentsAlwaysAllowPolicy object`
2169
2170 Tool calls are automatically approved without user confirmation.
2171
2172 - `BetaManagedAgentsAlwaysAskPolicy object`
2173
2174 Tool calls require user confirmation before execution.
2175
2176 - `BetaManagedAgentsAutoPolicy object`
2177
2178 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.
2179
2180 - `BetaManagedAgentsGrepToolConfig object`
2181
2182 Configuration for the grep tool.
2183
2184 - `type: "grep"`
2185
2186 - `enabled: boolean`
2187
2188 - `name: "grep"`
2189
2190 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2191
2192 Permission policy for tool execution.
2193
2194 - `BetaManagedAgentsAlwaysAllowPolicy object`
2195
2196 Tool calls are automatically approved without user confirmation.
2197
2198 - `BetaManagedAgentsAlwaysAskPolicy object`
2199
2200 Tool calls require user confirmation before execution.
2201
2202 - `BetaManagedAgentsAutoPolicy object`
2203
2204 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.
2205
2206 - `BetaManagedAgentsWebFetchToolConfig object`
2207
2208 Configuration for the web_fetch tool.
2209
2210 - `type: "web_fetch"`
2211
2212 - `enabled: boolean`
2213
2214 - `name: "web_fetch"`
2215
2216 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2217
2218 Permission policy for tool execution.
2219
2220 - `BetaManagedAgentsAlwaysAllowPolicy object`
2221
2222 Tool calls are automatically approved without user confirmation.
2223
2224 - `BetaManagedAgentsAlwaysAskPolicy object`
2225
2226 Tool calls require user confirmation before execution.
2227
2228 - `BetaManagedAgentsAutoPolicy object`
2229
2230 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.
2231
2232 - `url_sources: BetaManagedAgentsWebFetchURLSources or null`
2233
2234 Which sources contribute URLs the tool may fetch, always in the object form. Null when not set, which allows every source.
2235
2236 - `client_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
2237
2238 Which custom tools' results contribute URLs that may be fetched. Null when not set, which allows every custom tool's results.
2239
2240 - `BetaManagedAgentsWebFetchURLSourceAll object`
2241
2242 Every URL from this source may be fetched. This is the default.
2243
2244 - `type: "all"`
2245
2246 - `BetaManagedAgentsWebFetchURLSourceNone object`
2247
2248 This source contributes no URLs that may be fetched.
2249
2250 - `type: "none"`
2251
2252 - `BetaManagedAgentsWebFetchURLSourceOnly object`
2253
2254 Only the named tools' results contribute URLs that may be fetched.
2255
2256 - `type: "only"`
2257
2258 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
2259
2260 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.
2261
2262 - `type: "tool_reference"`
2263
2264 Must be "tool_reference".
2265
2266 - `name: string`
2267
2268 Name of the tool. Compared exactly, so upper and lower case letters are different.
2269
2270 minLength: 1, maxLength: 128
2271
2272 - `BetaManagedAgentsWebFetchURLSourceExcept object`
2273
2274 Every tool's results contribute URLs that may be fetched, except the named tools' results.
2275
2276 - `type: "except"`
2277
2278 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
2279
2280 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.
2281
2282 - `type: "tool_reference"`
2283
2284 Must be "tool_reference".
2285
2286 - `name: string`
2287
2288 Name of the tool. Compared exactly, so upper and lower case letters are different.
2289
2290 minLength: 1, maxLength: 128
2291
2292 - `server_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
2293
2294 Which of the web_search and web_fetch tools' results contribute URLs that may be fetched. Null when not set, which allows both.
2295
2296 - `user_input: BetaManagedAgentsWebFetchURLSourceUserInput or null`
2297
2298 Whether URLs in the text of user messages may be fetched. Null when not set, which allows them.
2299
2300 - `BetaManagedAgentsWebFetchURLSourceAll object`
2301
2302 Every URL from this source may be fetched. This is the default.
2303
2304 - `BetaManagedAgentsWebFetchURLSourceNone object`
2305
2306 This source contributes no URLs that may be fetched.
2307
2308 - `allowed_domains: optional array of string`
2309
2310 - `blocked_domains: optional array of string`
2311
2312 - `max_content_tokens: optional number or null`
2313
2314 format: int32
2315
2316 - `BetaManagedAgentsWebSearchToolConfig object`
2317
2318 Configuration for the web_search tool.
2319
2320 - `type: "web_search"`
2321
2322 - `enabled: boolean`
2323
2324 - `name: "web_search"`
2325
2326 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2327
2328 Permission policy for tool execution.
2329
2330 - `BetaManagedAgentsAlwaysAllowPolicy object`
2331
2332 Tool calls are automatically approved without user confirmation.
2333
2334 - `BetaManagedAgentsAlwaysAskPolicy object`
2335
2336 Tool calls require user confirmation before execution.
2337
2338 - `BetaManagedAgentsAutoPolicy object`
2339
2340 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.
2341
2342 - `allowed_domains: optional array of string`
2343
2344 - `blocked_domains: optional array of string`
2345
2346 - `user_location: optional BetaManagedAgentsUserLocation or null`
2347
2348 Approximate user location for search result localization.
2349
2350 - `type: "approximate"`
2351
2352 Location precision. Only "approximate" is supported.
2353
2354 - `city: optional string or null`
2355
2356 City name.
2357
2358 minLength: 1, maxLength: 255
2359
2360 - `country: optional string or null`
2361
2362 Two-letter ISO 3166-1 country code, uppercase.
2363
2364 - `region: optional string or null`
2365
2366 Region or state name.
2367
2368 minLength: 1, maxLength: 255
2369
2370 - `timezone: optional string or null`
2371
2372 IANA timezone identifier, e.g. "America/Los_Angeles".
2373
2374 minLength: 1, maxLength: 255
2375
2376 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
2377
2378 Resolved default configuration for agent tools.
20452379
20462380 - `enabled: boolean`
20472381
2048 - `name: "bash"`
2049
20502382 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
20512383
20522384 Permission policy for tool execution.
from line 2387
20552387
20562388 Tool calls are automatically approved without user confirmation.
20572389
2058 - `type: "always_allow"`
2059
20602390 - `BetaManagedAgentsAlwaysAskPolicy object`
20612391
20622392 Tool calls require user confirmation before execution.
20632393
2064 - `type: "always_ask"`
2065
20662394 - `BetaManagedAgentsAutoPolicy object`
20672395
20682396 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.
20692397
2070 - `type: "auto"`
2071
2072 - `BetaManagedAgentsEditToolConfig object`
2073
2074 Configuration for the edit tool.
2075
2076 - `type: "edit"`
2398 - `BetaManagedAgentsMCPToolset object`
2399
2400 - `type: "mcp_toolset"`
2401
2402 - `configs: array of BetaManagedAgentsMCPToolConfig`
20772403
20782404 - `enabled: boolean`
20792405
2080 - `name: "edit"`
2406 - `name: string`
20812407
20822408 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
20832409
from line 2421
20952421
20962422 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.
20972423
2098 - `BetaManagedAgentsReadToolConfig object`
2099
2100 Configuration for the read tool.
2101
2102 - `type: "read"`
2424 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
2425
2426 Resolved default configuration for all tools from an MCP server.
21032427
21042428 - `enabled: boolean`
21052429
2106 - `name: "read"`
2107
21082430 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
21092431
21102432 Permission policy for tool execution.
from line 2443
21212443
21222444 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.
21232445
2124 - `BetaManagedAgentsWriteToolConfig object`
2125
2126 Configuration for the write tool.
2127
2128 - `type: "write"`
2129
2130 - `enabled: boolean`
2131
2132 - `name: "write"`
2133
2134 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2135
2136 Permission policy for tool execution.
2137
2138 - `BetaManagedAgentsAlwaysAllowPolicy object`
2139
2140 Tool calls are automatically approved without user confirmation.
2141
2142 - `BetaManagedAgentsAlwaysAskPolicy object`
2143
2144 Tool calls require user confirmation before execution.
2145
2146 - `BetaManagedAgentsAutoPolicy object`
2147
2148 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.
2149
2150 - `BetaManagedAgentsGlobToolConfig object`
2151
2152 Configuration for the glob tool.
2153
2154 - `type: "glob"`
2155
2156 - `enabled: boolean`
2157
2158 - `name: "glob"`
2159
2160 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2161
2162 Permission policy for tool execution.
2163
2164 - `BetaManagedAgentsAlwaysAllowPolicy object`
2165
2166 Tool calls are automatically approved without user confirmation.
2167
2168 - `BetaManagedAgentsAlwaysAskPolicy object`
2169
2170 Tool calls require user confirmation before execution.
2171
2172 - `BetaManagedAgentsAutoPolicy object`
2173
2174 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.
2175
2176 - `BetaManagedAgentsGrepToolConfig object`
2177
2178 Configuration for the grep tool.
2179
2180 - `type: "grep"`
2181
2182 - `enabled: boolean`
2183
2184 - `name: "grep"`
2185
2186 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2187
2188 Permission policy for tool execution.
2189
2190 - `BetaManagedAgentsAlwaysAllowPolicy object`
2191
2192 Tool calls are automatically approved without user confirmation.
2193
2194 - `BetaManagedAgentsAlwaysAskPolicy object`
2195
2196 Tool calls require user confirmation before execution.
2197
2198 - `BetaManagedAgentsAutoPolicy object`
2199
2200 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.
2201
2202 - `BetaManagedAgentsWebFetchToolConfig object`
2203
2204 Configuration for the web_fetch tool.
2205
2206 - `type: "web_fetch"`
2207
2208 - `enabled: boolean`
2209
2210 - `name: "web_fetch"`
2211
2212 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2213
2214 Permission policy for tool execution.
2215
2216 - `BetaManagedAgentsAlwaysAllowPolicy object`
2217
2218 Tool calls are automatically approved without user confirmation.
2219
2220 - `BetaManagedAgentsAlwaysAskPolicy object`
2221
2222 Tool calls require user confirmation before execution.
2223
2224 - `BetaManagedAgentsAutoPolicy object`
2225
2226 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.
2227
2228 - `url_sources: BetaManagedAgentsWebFetchURLSources or null`
2229
2230 Which sources contribute URLs the tool may fetch, always in the object form. Null when not set, which allows every source.
2231
2232 - `client_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
2233
2234 Which custom tools' results contribute URLs that may be fetched. Null when not set, which allows every custom tool's results.
2235
2236 - `BetaManagedAgentsWebFetchURLSourceAll object`
2237
2238 Every URL from this source may be fetched. This is the default.
2239
2240 - `type: "all"`
2241
2242 - `BetaManagedAgentsWebFetchURLSourceNone object`
2243
2244 This source contributes no URLs that may be fetched.
2245
2246 - `type: "none"`
2247
2248 - `BetaManagedAgentsWebFetchURLSourceOnly object`
2249
2250 Only the named tools' results contribute URLs that may be fetched.
2251
2252 - `type: "only"`
2253
2254 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
2255
2256 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.
2257
2258 - `type: "tool_reference"`
2259
2260 Must be "tool_reference".
2261
2262 - `name: string`
2263
2264 Name of the tool. Compared exactly, so upper and lower case letters are different.
2265
2266 minLength: 1, maxLength: 128
2267
2268 - `BetaManagedAgentsWebFetchURLSourceExcept object`
2269
2270 Every tool's results contribute URLs that may be fetched, except the named tools' results.
2271
2272 - `type: "except"`
2273
2274 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
2275
2276 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.
2277
2278 - `type: "tool_reference"`
2279
2280 Must be "tool_reference".
2281
2282 - `name: string`
2283
2284 Name of the tool. Compared exactly, so upper and lower case letters are different.
2285
2286 minLength: 1, maxLength: 128
2287
2288 - `server_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
2289
2290 Which of the web_search and web_fetch tools' results contribute URLs that may be fetched. Null when not set, which allows both.
2291
2292 - `user_input: BetaManagedAgentsWebFetchURLSourceUserInput or null`
2293
2294 Whether URLs in the text of user messages may be fetched. Null when not set, which allows them.
2295
2296 - `BetaManagedAgentsWebFetchURLSourceAll object`
2297
2298 Every URL from this source may be fetched. This is the default.
2299
2300 - `BetaManagedAgentsWebFetchURLSourceNone object`
2301
2302 This source contributes no URLs that may be fetched.
2303
2304 - `allowed_domains: optional array of string`
2305
2306 - `blocked_domains: optional array of string`
2307
2308 - `max_content_tokens: optional number or null`
2309
2310 format: int32
2311
2312 - `BetaManagedAgentsWebSearchToolConfig object`
2313
2314 Configuration for the web_search tool.
2315
2316 - `type: "web_search"`
2317
2318 - `enabled: boolean`
2319
2320 - `name: "web_search"`
2321
2322 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2323
2324 Permission policy for tool execution.
2325
2326 - `BetaManagedAgentsAlwaysAllowPolicy object`
2327
2328 Tool calls are automatically approved without user confirmation.
2329
2330 - `BetaManagedAgentsAlwaysAskPolicy object`
2331
2332 Tool calls require user confirmation before execution.
2333
2334 - `BetaManagedAgentsAutoPolicy object`
2335
2336 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.
2337
2338 - `allowed_domains: optional array of string`
2339
2340 - `blocked_domains: optional array of string`
2341
2342 - `user_location: optional BetaManagedAgentsUserLocation or null`
2343
2344 Approximate user location for search result localization.
2345
2346 - `type: "approximate"`
2347
2348 Location precision. Only "approximate" is supported.
2349
2350 - `city: optional string or null`
2351
2352 City name.
2353
2354 minLength: 1, maxLength: 255
2355
2356 - `country: optional string or null`
2357
2358 Two-letter ISO 3166-1 country code, uppercase.
2359
2360 - `region: optional string or null`
2361
2362 Region or state name.
2363
2364 minLength: 1, maxLength: 255
2365
2366 - `timezone: optional string or null`
2367
2368 IANA timezone identifier, e.g. "America/Los_Angeles".
2369
2370 minLength: 1, maxLength: 255
2371
2372 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
2373
2374 Resolved default configuration for agent tools.
2375
2376 - `enabled: boolean`
2377
2378 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2379
2380 Permission policy for tool execution.
2381
2382 - `BetaManagedAgentsAlwaysAllowPolicy object`
2383
2384 Tool calls are automatically approved without user confirmation.
2385
2386 - `BetaManagedAgentsAlwaysAskPolicy object`
2387
2388 Tool calls require user confirmation before execution.
2389
2390 - `BetaManagedAgentsAutoPolicy object`
2391
2392 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.
2393
2394 - `BetaManagedAgentsMCPToolset object`
2395
2396 - `type: "mcp_toolset"`
2397
2398 - `configs: array of BetaManagedAgentsMCPToolConfig`
2399
2400 - `enabled: boolean`
2446 - `mcp_server_name: string`
2447
2448 - `BetaManagedAgentsCustomTool object`
2449
2450 A custom tool as returned in API responses.
2451
2452 - `type: "custom"`
2453
2454 - `description: string`
2455
2456 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
2457
2458 JSON Schema for custom tool input parameters.
2459
2460 - `type: "object"`
2461
2462 - `properties: optional map[unknown] or null`
2463
2464 - `required: optional array of string or null`
24012465
24022466 - `name: string`
24032467
2404 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2405
2406 Permission policy for tool execution.
2407
2408 - `BetaManagedAgentsAlwaysAllowPolicy object`
2409
2410 Tool calls are automatically approved without user confirmation.
2411
2412 - `BetaManagedAgentsAlwaysAskPolicy object`
2413
2414 Tool calls require user confirmation before execution.
2415
2416 - `BetaManagedAgentsAutoPolicy object`
2417
2418 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.
2419
2420 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
2421
2422 Resolved default configuration for all tools from an MCP server.
2423
2424 - `enabled: boolean`
2425
2426 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
2427
2428 Permission policy for tool execution.
2429
2430 - `BetaManagedAgentsAlwaysAllowPolicy object`
2431
2432 Tool calls are automatically approved without user confirmation.
2433
2434 - `BetaManagedAgentsAlwaysAskPolicy object`
2435
2436 Tool calls require user confirmation before execution.
2437
2438 - `BetaManagedAgentsAutoPolicy object`
2439
2440 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.
2441
2442 - `mcp_server_name: string`
2443
2444 - `BetaManagedAgentsCustomTool object`
2445
2446 A custom tool as returned in API responses.
2447
2448 - `type: "custom"`
2449
2450 - `description: string`
2451
2452 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
2453
2454 JSON Schema for custom tool input parameters.
2455
2456 - `type: "object"`
2457
2458 - `properties: optional map[unknown] or null`
2459
2460 - `required: optional array of string or null`
2468 - `version: number`
2469
2470 format: int32
2471
2472 - `BetaManagedAgentsAdvisor object`
2473
2474 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
2475
2476 - `type: "advisor"`
2477
2478 - `model: string`
2479
2480 The advisor model id.
2481
2482 - `BetaManagedAgentsSessionMultiagent20261001 object`
2483
2484 Resolved multiagent configuration with three members, as copied to the `session` at creation.
2485
2486 - `type: "multiagent_20261001"`
2487
2488 - `advisor: BetaManagedAgentsMultiagentAdvisor`
2489
2490 Whether the session's primary thread can consult an advisor model.
2491
2492 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
2493
2494 The session's primary thread can consult `model` mid-turn.
2495
2496 - `type: "enabled"`
2497
2498 - `model: string`
2499
2500 The advisor model id.
2501
2502 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
2503
2504 The agent has no advisor.
2505
2506 - `type: "disabled"`
2507
2508 - `subagents: BetaManagedAgentsSessionMultiagentSubagents`
2509
2510 Whether the agent can spawn session threads.
2511
2512 - `BetaManagedAgentsSessionMultiagentSubagentsEnabled object`
2513
2514 The agent can spawn session threads.
2515
2516 - `type: "enabled"`
2517
2518 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
2519
2520 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
2521
2522 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
2523
2524 The agent can define inline agents.
2525
2526 - `type: "enabled"`
2527
2528 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
2529
2530 The agent cannot define inline agents.
2531
2532 - `type: "disabled"`
2533
2534 - `predefined_agents: array of BetaManagedAgentsSessionThreadAgent`
2535
2536 Full `agent` definitions of the predefined agents, which are saved agents that this agent can spawn as session threads.
2537
2538 - `type: "agent"`
2539
2540 - `id: string`
2541
2542 - `description: string or null`
2543
2544 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
2545
2546 - `model: BetaManagedAgentsModelConfig`
2547
2548 Model identifier and configuration.
24612549
24622550 - `name: string`
24632551
2464 - `version: number`
2465
2466 format: int32
2467
2468 - `BetaManagedAgentsAdvisor object`
2469
2470 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
2471
2472 - `type: "advisor"`
2473
2474 - `model: string`
2475
2476 The advisor model id.
2552 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
2553
2554 - `system: string or null`
2555
2556 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
2557
2558 - `version: number`
2559
2560 format: int32
2561
2562 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
2563
2564 The agent cannot spawn session threads.
2565
2566 - `type: "disabled"`
2567
2568 - `workflows: BetaManagedAgentsSessionMultiagentWorkflows`
2569
2570 Whether the agent can start workflow runs.
2571
2572 - `BetaManagedAgentsSessionMultiagentWorkflowsEnabled object`
2573
2574 The agent can start workflow runs.
2575
2576 - `type: "enabled"`
2577
2578 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
2579
2580 Whether a run's plan can define inline agents, which are not saved.
2581
2582 - `predefined_agents: array of BetaManagedAgentsSessionThreadAgent`
2583
2584 Full `agent` definitions of the predefined agents, which are saved agents that a run's plan can use.
2585
2586 - `type: "agent"`
2587
2588 - `id: string`
2589
2590 - `description: string or null`
2591
2592 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
2593
2594 - `model: BetaManagedAgentsModelConfig`
2595
2596 Model identifier and configuration.
2597
2598 - `name: string`
2599
2600 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
2601
2602 - `system: string or null`
2603
2604 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
2605
2606 - `version: number`
2607
2608 format: int32
2609
2610 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
2611
2612 The agent cannot start workflow runs.
2613
2614 - `type: "disabled"`
24772615
24782616 - `name: string`
24792617
from line 2828
26902828 - `budget: optional BetaManagedAgentsBudgetLimit or null`
26912829
26922830 The session's configured budget at the snapshot time, or null when the session has no budget.
2831
2832 - `BetaManagedAgentsWorkflowRunCreatedEvent object`
2833
2834 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.
2835
2836 - `type: "workflow_run.created"`
2837
2838 - `id: string`
2839
2840 Unique identifier for this event.
2841
2842 - `description: string or null`
2843
2844 Description that the agent gave the run, passed on as written, or `null` if it gave none.
2845
2846 - `name: string`
2847
2848 Name that the agent gave the run, passed on as written, or a name that the server assigned.
2849
2850 - `phases: array of BetaManagedAgentsWorkflowRunPhase`
2851
2852 The phases that the run's plan declares, in the plan's order. Can be empty.
2853
2854 - `id: string`
2855
2856 Unique identifier for the phase.
2857
2858 - `description: string or null`
2859
2860 Description that the agent gave the phase, passed on as written, or `null` if it gave none.
2861
2862 - `name: string`
2863
2864 Name that the agent gave the phase, passed on as written.
2865
2866 - `processed_at: string`
2867
2868 Timestamp when this event was processed.
2869
2870 format: date-time
2871
2872 - `workflow_run_id: string`
2873
2874 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
2875
2876 - `BetaManagedAgentsWorkflowRunStatusEndedEvent object`
2877
2878 A workflow run ended. Emitted once per run, as the last of the run's `workflow_run.*` events.
2879
2880 - `type: "workflow_run.status_ended"`
2881
2882 - `id: string`
2883
2884 Unique identifier for this event.
2885
2886 - `processed_at: string`
2887
2888 Timestamp when this event was processed.
2889
2890 format: date-time
2891
2892 - `result: BetaManagedAgentsWorkflowRunResult`
2893
2894 How the run ended.
2895
2896 - `BetaManagedAgentsWorkflowRunResultCompleted object`
2897
2898 The run's plan, a program that the agent wrote, finished. This does not say whether the work succeeded.
2899
2900 - `type: "completed"`
2901
2902 - `BetaManagedAgentsWorkflowRunResultError object`
2903
2904 The run failed or reached its time limit.
2905
2906 - `type: "error"`
2907
2908 - `error: BetaManagedAgentsWorkflowRunError`
2909
2910 Why the run did not finish.
2911
2912 - `BetaManagedAgentsTimeoutWorkflowRunError object`
2913
2914 The run reached its time limit.
2915
2916 - `type: "timeout_error"`
2917
2918 - `message: string`
2919
2920 Short explanation written by the server. It never contains content from the run or its agents.
2921
2922 - `BetaManagedAgentsProgramWorkflowRunError object`
2923
2924 The plan, a program that the agent wrote, failed, or the server refused it.
2925
2926 - `type: "program_error"`
2927
2928 - `message: string`
2929
2930 Short explanation written by the server. It never contains content from the run or its agents.
2931
2932 - `BetaManagedAgentsUnknownWorkflowRunError object`
2933
2934 A failure that has no type of its own.
2935
2936 - `type: "unknown_error"`
2937
2938 - `message: string`
2939
2940 Short explanation written by the server. It never contains content from the run or its agents.
2941
2942 - `BetaManagedAgentsThreadLimitWorkflowRunError object`
2943
2944 The run exceeded the limit on the number of threads that a run can create.
2945
2946 - `type: "thread_limit_error"`
2947
2948 - `message: string`
2949
2950 Short explanation written by the server. It never contains content from the run or its agents.
2951
2952 - `BetaManagedAgentsMaxWorkflowRunsWorkflowRunError object`
2953
2954 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.
2955
2956 - `type: "max_workflow_runs_error"`
2957
2958 - `message: string`
2959
2960 Short explanation written by the server. It never contains content from the run or its agents.
2961
2962 - `BetaManagedAgentsWorkflowRunResultStopped object`
2963
2964 The agent stopped the run.
2965
2966 - `type: "stopped"`
2967
2968 - `workflow_run_id: string`
2969
2970 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
2971
2972 - `BetaManagedAgentsWorkflowRunPhaseStartedEvent object`
2973
2974 A workflow run's plan entered a phase.
2975
2976 - `type: "workflow_run.phase_started"`
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 - `workflow_run_phase_id: string`
2993
2994 Identifier of the phase, as in `phases` on the run's `workflow_run.created` event.
2995
2996 - `BetaManagedAgentsWorkflowRunPhaseEndedEvent object`
2997
2998 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.
2999
3000 - `type: "workflow_run.phase_ended"`
3001
3002 - `id: string`
3003
3004 Unique identifier for this event.
3005
3006 - `phase_started_id: string`
3007
3008 Identifier of the `workflow_run.phase_started` event that opened the phase.
3009
3010 - `processed_at: string`
3011
3012 Timestamp when this event was processed.
3013
3014 format: date-time
3015
3016 - `workflow_run_id: string`
3017
3018 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
3019
3020 - `workflow_run_phase_id: string`
3021
3022 Identifier of the phase, as in `phases` on the run's `workflow_run.created` event.
3023
3024 - `BetaManagedAgentsWorkflowRunStatusRunningEvent object`
3025
3026 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.
3027
3028 - `type: "workflow_run.status_running"`
3029
3030 - `id: string`
3031
3032 Unique identifier for this event.
3033
3034 - `processed_at: string`
3035
3036 Timestamp when this event was processed.
3037
3038 format: date-time
3039
3040 - `workflow_run_id: string`
3041
3042 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
3043
3044 - `BetaManagedAgentsWorkflowRunStatusIdleEvent object`
3045
3046 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`.
3047
3048 - `type: "workflow_run.status_idle"`
3049
3050 - `id: string`
3051
3052 Unique identifier for this event.
3053
3054 - `processed_at: string`
3055
3056 Timestamp when this event was processed.
3057
3058 format: date-time
3059
3060 - `workflow_run_id: string`
3061
3062 Identifier of the run. The same value is on all of the run's `workflow_run.*` events.
3063
3064 - `BetaManagedAgentsWorkflowRunErrorEvent object`
3065
3066 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`.
3067
3068 - `type: "workflow_run.error"`
3069
3070 - `id: string`
3071
3072 Unique identifier for this event.
3073
3074 - `error: BetaManagedAgentsWorkflowRunError`
3075
3076 Why the run did not finish, or was not created.
3077
3078 - `processed_at: string`
3079
3080 Timestamp when this event was processed.
3081
3082 format: date-time
3083
3084 - `workflow_run_id: string or null`
3085
3086 Identifier of the run that met the error, or `null` when the error kept a run from being created.
26933087
26943088## Example
26953089
26963090
No line in this hunk matches that.