One read of Claude Developer Platformapi-20260820T170710Z
229 pages moved out of 583 read.
Pages moved
229
significant first
Pages read
583
in this capture
Captured
17:07 UTC
Corpus hash
9cf0330dc487
corpus-hash
What this read moved
51-75 of 229, page 3 of 10This capture is too large to show at once. Changes 51-75 of 229 are below, significant first; the rest are on the following screens.
api/beta/messages/count_tokens Changed · +885 / -129 lines
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 21
2121
2222 - `string`
2323
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2525
2626 - `"message-batches-2024-09-24"`
2727
from line 66
6666 - `"output-300k-2026-03-24"`
6767
6868 - `"user-profiles-2026-03-24"`
69
70 - `"user-profiles-2026-08-18"`
6971
7072 - `"advisor-tool-2026-03-01"`
7173
from line 291
289291
290292 - `"search_result_location"`
291293
292 - `BetaImageBlockParam object { source, type, cache_control }`
294 - `BetaImageBlockParam object { source, type, cache_control, transformations }`
293295
294296 - `source: BetaBase64ImageSource or BetaURLImageSource or BetaFileImageSource`
295297
from line 337
335337
336338 Create a cache control breakpoint at this content block.
337339
340 - `transformations: optional BetaImageTransformationsParam or null`
341
342 Configures the transformations the server applies to this image before the model observes it. Each key names a condition the server transforms images for; its value selects the transformation applied. Omitted keys keep their default behavior, and an empty object is equivalent to omitting the field.
343
344 - `oversized_image: optional "downsize" or "error"`
345
346 What the server does when this image exceeds the model's maximum image size. `"downsize"` (the default) scales the image down to fit, which changes the dimensions the model observes without telling you. `"error"` instead rejects the request with a 400 error naming the image's dimensions and the largest dimensions that fit, so you can scale the image deliberately — your image is never silently scaled down.
347
348 - `"downsize"`
349
350 - `"error"`
351
338352 - `BetaRequestDocumentBlock object { source, type, cache_control, 3 more }`
339353
340354 - `source: BetaBase64PDFSource or BetaPlainTextSource or BetaContentBlockSource or 2 more`
from line 387
373387
374388 - `BetaTextBlockParam object { text, type, cache_control, citations }`
375389
376 - `BetaImageBlockParam object { source, type, cache_control }`
390 - `BetaImageBlockParam object { source, type, cache_control, transformations }`
377391
378392 - `type: "content"`
379393
from line 479
465479
466480 - `"redacted_thinking"`
467481
468 - `BetaToolUseBlockParam object { id, input, name, 3 more }`
482 - `BetaToolUseBlockParam object { id, input, name, 4 more }`
469483
470484 - `id: string`
471485
from line 525
511525
512526 - `"code_execution_20260120"`
513527
514 - `BetaToolResultBlockParam object { tool_use_id, type, cache_control, 2 more }`
528 - `toolset_name: optional string or null`
529
530 For a toolset member tool_use, the toolset family this member belongs to.
531
532 - `BetaToolResultBlockParam object { tool_use_id, type, cache_control, 3 more }`
515533
516534 - `tool_use_id: string`
517535
from line 541
523541
524542 Create a cache control breakpoint at this content block.
525543
526 - `content: optional string or array of BetaTextBlockParam or BetaImageBlockParam or BetaSearchResultBlockParam or 2 more`
544 - `content: optional string or array of BetaTextBlockParam or BetaImageBlockParam or BetaSearchResultBlockParam or 3 more`
527545
528546 - `string`
529547
530 - `array of BetaTextBlockParam or BetaImageBlockParam or BetaSearchResultBlockParam or 2 more`
548 - `array of BetaTextBlockParam or BetaImageBlockParam or BetaSearchResultBlockParam or 3 more`
531549
532550 - `BetaTextBlockParam object { text, type, cache_control, citations }`
533551
534 - `BetaImageBlockParam object { source, type, cache_control }`
552 - `BetaImageBlockParam object { source, type, cache_control, transformations }`
535553
536554 - `BetaSearchResultBlockParam object { content, source, title, 3 more }`
537555
from line 569
551569
552570 Create a cache control breakpoint at this content block.
553571
572 - `BetaBrowserStateBlockParam object { tabs, type, cache_control, state_changes }`
573
574 The caller's browser state after a browser toolset member call —
575 the full inventory of open tabs, which tab is active, and any side
576 effects (tabs opened, download state changes) the call produced.
577
578 At most one per `tool_result`, only on a non-error result answering a
579 browser toolset member `tool_use`. The server renders the
580 model-visible text from it; the model never sees the raw fields.
581
582 - `tabs: array of BetaBrowserStateTabEntry`
583
584 All tabs open in the browser after this call — the full inventory, not a delta. May be empty. Whenever non-empty, exactly one entry carries `active: true`.
585
586 - `tab_id: string`
587
588 The caller-assigned identifier for this tab, unique within the inventory.
589
590 - `title: string`
591
592 The title of the page the tab is showing. May be empty.
593
594 - `url: string`
595
596 The URL of the page the tab is showing. May be empty.
597
598 - `active: optional boolean`
599
600 Whether this tab is the active tab after this call. Whenever `tabs` is non-empty, exactly one entry is marked `active: true`.
601
602 - `type: "browser_state"`
603
604 - `"browser_state"`
605
606 - `cache_control: optional BetaCacheControlEphemeral or null`
607
608 Create a cache control breakpoint at this content block.
609
610 - `state_changes: optional array of BetaBrowserStateChange or null`
611
612 Tabs opened and download state changes during this call. "Nothing to report" is expressed by omitting the field, never by an empty list.
613
614 - `BetaBrowserStateChangeTabOpened object { tab_id, type }`
615
616 A tab this call's execution opened that remains open at its end —
617 the creation delta of the `tabs` inventory, not an event log.
618
619 Carries only the `tab_id`; the tab's `title` and `url` live on its
620 `tabs` entry, which must include the same `tab_id`. A tab opened
621 during a failed call gets no deferred `tab_opened`; it simply appears
622 in the next result's `tabs` inventory.
623
624 - `tab_id: string`
625
626 The `tab_id` of the opened tab, present in `tabs`.
627
628 - `type: "tab_opened"`
629
630 - `"tab_opened"`
631
632 - `BetaBrowserStateChangeDownloadStarted object { download_id, type, url }`
633
634 A file download that started during this call.
635
636 - `download_id: string`
637
638 The caller-assigned identifier for this download, stable across the state changes reporting it.
639
640 - `type: "download_started"`
641
642 - `"download_started"`
643
644 - `url: string`
645
646 The final post-redirect URL the download was served from.
647
648 - `BetaBrowserStateChangeDownloadCompleted object { download_id, type, url, 2 more }`
649
650 A file download that finished during this call, reported with the
651 same `download_id` as its `download_started` — or without a prior
652 `download_started`, when the download finished during the call that
653 started it (at most one state change per `download_id` per result).
654
655 - `download_id: string`
656
657 The caller-assigned identifier for this download, stable across the state changes reporting it.
658
659 - `type: "download_completed"`
660
661 - `"download_completed"`
662
663 - `url: string`
664
665 The final post-redirect URL the download was served from.
666
667 - `path: optional string or null`
668
669 Where the executor saved the file, on the executor's filesystem. Only included when another tool in the same environment can read the file at that path.
670
671 - `size_bytes: optional number or null`
672
673 The completed download's size.
674
675 - `BetaBrowserStateChangeDownloadFailed object { download_id, type, url, error }`
676
677 A file download that failed — or was cancelled — during this call.
678
679 - `download_id: string`
680
681 The caller-assigned identifier for this download, stable across the state changes reporting it.
682
683 - `type: "download_failed"`
684
685 - `"download_failed"`
686
687 - `url: string`
688
689 The final post-redirect URL the download was served from.
690
691 - `error: optional string or null`
692
693 The failure or cancellation detail, when known.
694
554695 - `is_error: optional boolean`
696
697 - `toolset_name: optional string or null`
698
699 For a toolset member tool_result, the toolset family of the paired tool_use.
555700
556701 - `BetaServerToolUseBlockParam object { id, input, name, 3 more }`
557702
from line 1276
11311276 - `encrypted_content: optional string or null`
11321277
11331278 Opaque metadata from prior compaction, to be round-tripped verbatim
1134
1135 - `BetaMidConversationSystemBlockParam object { content, type, cache_control }`
1136
1137 System instructions that appear mid-conversation.
1138
1139 Use this block to provide or update system-level instructions at a specific
1140 point in the conversation, rather than only via the top-level `system` parameter.
1141
1142 - `content: array of BetaTextBlockParam or BetaRequestToolAdditionBlock or BetaRequestToolRemovalBlock`
1143
1144 System instruction text blocks.
1145
1146 - `BetaTextBlockParam object { text, type, cache_control, citations }`
1147
1148 - `BetaRequestToolAdditionBlock object { tool, type, cache_control }`
1149
1150 Mid-conversation directive to surface a declared tool.
1151
1152 `tool` references a tool (or MCP toolset) by name from the request's
1153 `tools`; it is offered to the model from this point in the
1154 conversation onward.
1155
1156 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`
1157
1158 Reference to a single tool the caller declared directly in
1159 `tools[]`. Does not accept the composed `{server}_{name}` form the
1160 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1161 `mcp_toolset_reference` for those.
1162
1163 - `BetaToolChangeToolReference object { name, type }`
1164
1165 Reference to a single tool the caller declared directly in
1166 `tools[]`. Does not accept the composed `{server}_{name}` form the
1167 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1168 `mcp_toolset_reference` for those.
1169
1170 - `name: string`
1171
1172 - `type: "tool_reference"`
1173
1174 - `"tool_reference"`
1175
1176 - `BetaToolChangeMCPToolReference object { name, server_name, type }`
1177
1178 Reference to a single MCP tool by its server and remote name — the
1179 same `server_name`/`name` pair `mcp_tool_use` carries.
1180
1181 - `name: string`
1182
1183 - `server_name: string`
1184
1185 - `type: "mcp_tool_reference"`
1186
1187 - `"mcp_tool_reference"`
1188
1189 - `BetaToolChangeMCPToolsetReference object { server_name, type }`
1190
1191 Reference to every tool in the named MCP server's toolset.
1192
1193 - `server_name: string`
1194
1195 - `type: "mcp_toolset_reference"`
1196
1197 - `"mcp_toolset_reference"`
1198
1199 - `type: "tool_addition"`
1200
1201 - `"tool_addition"`
1202
1203 - `cache_control: optional BetaCacheControlEphemeral or null`
1204
1205 Create a cache control breakpoint at this content block.
1206
1207 - `BetaRequestToolRemovalBlock object { tool, type, cache_control }`
1208
1209 Mid-conversation directive to withdraw a tool.
1210
1211 `tool` references a tool (or MCP toolset) by name from the request's
1212 `tools`; it is no longer offered to the model from this point in the
1213 conversation onward.
1214
1215 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`
1216
1217 Reference to a single tool the caller declared directly in
1218 `tools[]`. Does not accept the composed `{server}_{name}` form the
1219 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1220 `mcp_toolset_reference` for those.
1221
1222 - `BetaToolChangeToolReference object { name, type }`
1223
1224 Reference to a single tool the caller declared directly in
1225 `tools[]`. Does not accept the composed `{server}_{name}` form the
1226 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1227 `mcp_toolset_reference` for those.
1228
1229 - `BetaToolChangeMCPToolReference object { name, server_name, type }`
1230
1231 Reference to a single MCP tool by its server and remote name — the
1232 same `server_name`/`name` pair `mcp_tool_use` carries.
1233
1234 - `BetaToolChangeMCPToolsetReference object { server_name, type }`
1235
1236 Reference to every tool in the named MCP server's toolset.
1237
1238 - `type: "tool_removal"`
1239
1240 - `"tool_removal"`
1241
1242 - `cache_control: optional BetaCacheControlEphemeral or null`
1243
1244 Create a cache control breakpoint at this content block.
1245
1246 - `type: "mid_conv_system"`
1247
1248 - `"mid_conv_system"`
1249
1250 - `cache_control: optional BetaCacheControlEphemeral or null`
1251
1252 Create a cache control breakpoint at this content block.
12531279
12541280 - `BetaRequestToolAdditionBlock object { tool, type, cache_control }`
12551281
from line 1285
12591285 `tools`; it is offered to the model from this point in the
12601286 conversation onward.
12611287
1288 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`
1289
1290 Reference to a single tool the caller declared directly in
1291 `tools[]`. Does not accept the composed `{server}_{name}` form the
1292 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1293 `mcp_toolset_reference` for those.
1294
1295 - `BetaToolChangeToolReference object { name, type }`
1296
1297 Reference to a single tool the caller declared directly in
1298 `tools[]`. Does not accept the composed `{server}_{name}` form the
1299 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1300 `mcp_toolset_reference` for those.
1301
1302 - `name: string`
1303
1304 - `type: "tool_reference"`
1305
1306 - `"tool_reference"`
1307
1308 - `BetaToolChangeMCPToolReference object { name, server_name, type }`
1309
1310 Reference to a single MCP tool by its server and remote name — the
1311 same `server_name`/`name` pair `mcp_tool_use` carries.
1312
1313 - `name: string`
1314
1315 - `server_name: string`
1316
1317 - `type: "mcp_tool_reference"`
1318
1319 - `"mcp_tool_reference"`
1320
1321 - `BetaToolChangeMCPToolsetReference object { server_name, type }`
1322
1323 Reference to every tool in the named MCP server's toolset.
1324
1325 - `server_name: string`
1326
1327 - `type: "mcp_toolset_reference"`
1328
1329 - `"mcp_toolset_reference"`
1330
1331 - `type: "tool_addition"`
1332
1333 - `"tool_addition"`
1334
1335 - `cache_control: optional BetaCacheControlEphemeral or null`
1336
1337 Create a cache control breakpoint at this content block.
1338
12621339 - `BetaRequestToolRemovalBlock object { tool, type, cache_control }`
12631340
12641341 Mid-conversation directive to withdraw a tool.
from line 1343
12661343 `tool` references a tool (or MCP toolset) by name from the request's
12671344 `tools`; it is no longer offered to the model from this point in the
12681345 conversation onward.
1346
1347 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`
1348
1349 Reference to a single tool the caller declared directly in
1350 `tools[]`. Does not accept the composed `{server}_{name}` form the
1351 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1352 `mcp_toolset_reference` for those.
1353
1354 - `BetaToolChangeToolReference object { name, type }`
1355
1356 Reference to a single tool the caller declared directly in
1357 `tools[]`. Does not accept the composed `{server}_{name}` form the
1358 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1359 `mcp_toolset_reference` for those.
1360
1361 - `BetaToolChangeMCPToolReference object { name, server_name, type }`
1362
1363 Reference to a single MCP tool by its server and remote name — the
1364 same `server_name`/`name` pair `mcp_tool_use` carries.
1365
1366 - `BetaToolChangeMCPToolsetReference object { server_name, type }`
1367
1368 Reference to every tool in the named MCP server's toolset.
1369
1370 - `type: "tool_removal"`
1371
1372 - `"tool_removal"`
1373
1374 - `cache_control: optional BetaCacheControlEphemeral or null`
1375
1376 Create a cache control breakpoint at this content block.
12691377
12701378 - `BetaFallbackBlockParam object { from, to, type, trigger }`
12711379
from line 1825
17171825
17181826 - `"none"`
17191827
1720- `tools: optional array of BetaTool or BetaToolBash20241022 or BetaToolBash20250124 or 23 more`
1828- `tools: optional array of BetaTool or BetaToolBash20241022 or BetaToolBash20250124 or 25 more`
17211829
17221830 Definitions of tools that the model may use.
17231831
from line 2173
20652173
20662174 When true, guarantees schema validation on tool names and inputs
20672175
2176 - `BetaBrowserToolset20260801 object { type, allowed_callers, cache_control, configs }`
2177
2178 The browser toolset: a single `tools[]` entry (carrying no
2179 `name`) that declares the browser tool family. The model is served
2180 the family's tool with any members disabled via `configs` removed
2181 from its schema.
2182
2183 - `type: "browser_toolset_20260801"`
2184
2185 - `"browser_toolset_20260801"`
2186
2187 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2188
2189 - `"direct"`
2190
2191 - `"code_execution_20250825"`
2192
2193 - `"code_execution_20260120"`
2194
2195 - `"code_execution_20260521"`
2196
2197 - `cache_control: optional BetaCacheControlEphemeral or null`
2198
2199 Create a cache control breakpoint at this content block.
2200
2201 - `configs: optional BetaBrowserToolsetConfigs or null`
2202
2203 Per-member configuration for `browser_toolset_20260801`: one
2204 optional field per member tool, keyed by the member name — the same
2205 name the member's `tool_use` blocks carry. Every member is an
2206 accepted key, and a member's defaults apply wherever its key is
2207 absent. Unknown keys are rejected: the field set is this toolset
2208 version's complete member set.
2209
2210 - `close_tab: optional BetaBrowserCloseTabConfig or null`
2211
2212 `close_tab`'s config overrides.
2213
2214 - `defer_loading: optional boolean or null`
2215
2216 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2217
2218 - `enabled: optional boolean or null`
2219
2220 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2221
2222 - `double_click: optional BetaBrowserDoubleClickConfig or null`
2223
2224 `double_click`'s config overrides.
2225
2226 - `defer_loading: optional boolean or null`
2227
2228 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2229
2230 - `enabled: optional boolean or null`
2231
2232 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2233
2234 - `file_upload: optional BetaBrowserFileUploadConfig or null`
2235
2236 `file_upload`'s config overrides.
2237
2238 - `defer_loading: optional boolean or null`
2239
2240 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2241
2242 - `enabled: optional boolean or null`
2243
2244 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2245
2246 - `find: optional BetaBrowserFindConfig or null`
2247
2248 `find`'s config overrides.
2249
2250 - `defer_loading: optional boolean or null`
2251
2252 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2253
2254 - `enabled: optional boolean or null`
2255
2256 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2257
2258 - `form_input: optional BetaBrowserFormInputConfig or null`
2259
2260 `form_input`'s config overrides.
2261
2262 - `defer_loading: optional boolean or null`
2263
2264 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2265
2266 - `enabled: optional boolean or null`
2267
2268 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2269
2270 - `get_page_text: optional BetaBrowserGetPageTextConfig or null`
2271
2272 `get_page_text`'s config overrides.
2273
2274 - `defer_loading: optional boolean or null`
2275
2276 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2277
2278 - `enabled: optional boolean or null`
2279
2280 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2281
2282 - `hold_key: optional BetaBrowserHoldKeyConfig or null`
2283
2284 `hold_key`'s config overrides.
2285
2286 - `defer_loading: optional boolean or null`
2287
2288 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2289
2290 - `enabled: optional boolean or null`
2291
2292 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2293
2294 - `hover: optional BetaBrowserHoverConfig or null`
2295
2296 `hover`'s config overrides.
2297
2298 - `defer_loading: optional boolean or null`
2299
2300 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2301
2302 - `enabled: optional boolean or null`
2303
2304 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2305
2306 - `javascript_exec: optional BetaBrowserJavascriptExecConfig or null`
2307
2308 `javascript_exec`'s config overrides.
2309
2310 - `defer_loading: optional boolean or null`
2311
2312 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2313
2314 - `enabled: optional boolean or null`
2315
2316 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2317
2318 - `key: optional BetaBrowserKeyConfig or null`
2319
2320 `key`'s config overrides.
2321
2322 - `defer_loading: optional boolean or null`
2323
2324 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2325
2326 - `enabled: optional boolean or null`
2327
2328 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2329
2330 - `left_click: optional BetaBrowserLeftClickConfig or null`
2331
2332 `left_click`'s config overrides.
2333
2334 - `defer_loading: optional boolean or null`
2335
2336 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2337
2338 - `enabled: optional boolean or null`
2339
2340 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2341
2342 - `left_click_drag: optional BetaBrowserLeftClickDragConfig or null`
2343
2344 `left_click_drag`'s config overrides.
2345
2346 - `defer_loading: optional boolean or null`
2347
2348 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2349
2350 - `enabled: optional boolean or null`
2351
2352 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2353
2354 - `left_mouse_down: optional BetaBrowserLeftMouseDownConfig or null`
2355
2356 `left_mouse_down`'s config overrides.
2357
2358 - `defer_loading: optional boolean or null`
2359
2360 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2361
2362 - `enabled: optional boolean or null`
2363
2364 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2365
2366 - `left_mouse_up: optional BetaBrowserLeftMouseUpConfig or null`
2367
2368 `left_mouse_up`'s config overrides.
2369
2370 - `defer_loading: optional boolean or null`
2371
2372 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2373
2374 - `enabled: optional boolean or null`
2375
2376 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2377
2378 - `list_tabs: optional BetaBrowserListTabsConfig or null`
2379
2380 `list_tabs`'s config overrides.
2381
2382 - `defer_loading: optional boolean or null`
2383
2384 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2385
2386 - `enabled: optional boolean or null`
2387
2388 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2389
2390 - `middle_click: optional BetaBrowserMiddleClickConfig or null`
2391
2392 `middle_click`'s config overrides.
2393
2394 - `defer_loading: optional boolean or null`
2395
2396 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2397
2398 - `enabled: optional boolean or null`
2399
2400 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2401
2402 - `mouse_move: optional BetaBrowserMouseMoveConfig or null`
2403
2404 `mouse_move`'s config overrides.
2405
2406 - `defer_loading: optional boolean or null`
2407
2408 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2409
2410 - `enabled: optional boolean or null`
2411
2412 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2413
2414 - `navigate: optional BetaBrowserNavigateConfig or null`
2415
2416 `navigate`'s config overrides.
2417
2418 - `defer_loading: optional boolean or null`
2419
2420 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2421
2422 - `enabled: optional boolean or null`
2423
2424 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2425
2426 - `new_tab: optional BetaBrowserNewTabConfig or null`
2427
2428 `new_tab`'s config overrides.
2429
2430 - `defer_loading: optional boolean or null`
2431
2432 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2433
2434 - `enabled: optional boolean or null`
2435
2436 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2437
2438 - `read_console: optional BetaBrowserReadConsoleConfig or null`
2439
2440 `read_console`'s config overrides.
2441
2442 - `defer_loading: optional boolean or null`
2443
2444 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2445
2446 - `enabled: optional boolean or null`
2447
2448 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2449
2450 - `read_network: optional BetaBrowserReadNetworkConfig or null`
2451
2452 `read_network`'s config overrides.
2453
2454 - `defer_loading: optional boolean or null`
2455
2456 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2457
2458 - `enabled: optional boolean or null`
2459
2460 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2461
2462 - `read_page: optional BetaBrowserReadPageConfig or null`
2463
2464 `read_page`'s config overrides.
2465
2466 - `defer_loading: optional boolean or null`
2467
2468 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2469
2470 - `enabled: optional boolean or null`
2471
2472 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2473
2474 - `right_click: optional BetaBrowserRightClickConfig or null`
2475
2476 `right_click`'s config overrides.
2477
2478 - `defer_loading: optional boolean or null`
2479
2480 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2481
2482 - `enabled: optional boolean or null`
2483
2484 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2485
2486 - `screenshot: optional BetaBrowserScreenshotConfig or null`
2487
2488 `screenshot`'s config overrides.
2489
2490 - `defer_loading: optional boolean or null`
2491
2492 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2493
2494 - `enabled: optional boolean or null`
2495
2496 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2497
2498 - `scroll: optional BetaBrowserScrollConfig or null`
2499
2500 `scroll`'s config overrides.
2501
2502 - `defer_loading: optional boolean or null`
2503
2504 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2505
2506 - `enabled: optional boolean or null`
2507
2508 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2509
2510 - `scroll_to: optional BetaBrowserScrollToConfig or null`
2511
2512 `scroll_to`'s config overrides.
2513
2514 - `defer_loading: optional boolean or null`
2515
2516 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2517
2518 - `enabled: optional boolean or null`
2519
2520 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2521
2522 - `switch_tab: optional BetaBrowserSwitchTabConfig or null`
2523
2524 `switch_tab`'s config overrides.
2525
2526 - `defer_loading: optional boolean or null`
2527
2528 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2529
2530 - `enabled: optional boolean or null`
2531
2532 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2533
2534 - `triple_click: optional BetaBrowserTripleClickConfig or null`
2535
2536 `triple_click`'s config overrides.
2537
2538 - `defer_loading: optional boolean or null`
2539
2540 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2541
2542 - `enabled: optional boolean or null`
2543
2544 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2545
2546 - `type: optional BetaBrowserTypeConfig or null`
2547
2548 `type`'s config overrides.
2549
2550 - `defer_loading: optional boolean or null`
2551
2552 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2553
2554 - `enabled: optional boolean or null`
2555
2556 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2557
2558 - `wait: optional BetaBrowserWaitConfig or null`
2559
2560 `wait`'s config overrides.
2561
2562 - `defer_loading: optional boolean or null`
2563
2564 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2565
2566 - `enabled: optional boolean or null`
2567
2568 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2569
2570 - `zoom: optional BetaBrowserZoomConfig or null`
2571
2572 `zoom`'s config overrides.
2573
2574 - `defer_loading: optional boolean or null`
2575
2576 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2577
2578 - `enabled: optional boolean or null`
2579
2580 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2581
20682582 - `BetaToolComputerUse20241022 object { display_height_px, display_width_px, name, 7 more }`
20692583
20702584 - `display_height_px: number`
from line 2808
22942808 - `strict: optional boolean`
22952809
22962810 When true, guarantees schema validation on tool names and inputs
2811
2812 - `BetaComputerToolset20260801 object { type, allowed_callers, cache_control, configs }`
2813
2814 The computer toolset: a single `tools[]` entry (carrying no
2815 `name`) that declares the computer tool family. The model is
2816 served the family's tool with any members disabled via `configs`
2817 removed from its schema. Every member is enabled by default, zoom
2818 included. The single-tool options `display_number` and
2819 `enable_zoom` are not fields of a toolset entry — it carries only
2820 `type`, `configs`, and `cache_control`; zoom is controlled
2821 via `configs.zoom.enabled`.
2822
2823 - `type: "computer_toolset_20260801"`
2824
2825 - `"computer_toolset_20260801"`
2826
2827 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2828
2829 - `"direct"`
2830
2831 - `"code_execution_20250825"`
2832
2833 - `"code_execution_20260120"`
2834
2835 - `"code_execution_20260521"`
2836
2837 - `cache_control: optional BetaCacheControlEphemeral or null`
2838
2839 Create a cache control breakpoint at this content block.
2840
2841 - `configs: optional BetaComputerToolsetConfigs or null`
2842
2843 Per-member configuration for `computer_toolset_20260801`: one
2844 optional field per member tool, keyed by the member name — the same
2845 name the member's `tool_use` blocks carry. Every member is an
2846 accepted key, and a member's defaults apply wherever its key is
2847 absent. Unknown keys are rejected: the field set is this toolset
2848 version's complete member set.
2849
2850 - `cursor_position: optional BetaComputerCursorPositionConfig or null`
2851
2852 `cursor_position`'s config overrides.
2853
2854 - `defer_loading: optional boolean or null`
2855
2856 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2857
2858 - `enabled: optional boolean or null`
2859
2860 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2861
2862 - `double_click: optional BetaComputerDoubleClickConfig or null`
2863
2864 `double_click`'s config overrides.
2865
2866 - `defer_loading: optional boolean or null`
2867
2868 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2869
2870 - `enabled: optional boolean or null`
2871
2872 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2873
2874 - `hold_key: optional BetaComputerHoldKeyConfig or null`
2875
2876 `hold_key`'s config overrides.
2877
2878 - `defer_loading: optional boolean or null`
2879
2880 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2881
2882 - `enabled: optional boolean or null`
2883
2884 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2885
2886 - `key: optional BetaComputerKeyConfig or null`
2887
2888 `key`'s config overrides.
2889
2890 - `defer_loading: optional boolean or null`
2891
2892 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2893
2894 - `enabled: optional boolean or null`
2895
2896 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2897
2898 - `left_click: optional BetaComputerLeftClickConfig or null`
2899
2900 `left_click`'s config overrides.
2901
2902 - `defer_loading: optional boolean or null`
2903
2904 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2905
2906 - `enabled: optional boolean or null`
2907
2908 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2909
2910 - `left_click_drag: optional BetaComputerLeftClickDragConfig or null`
2911
2912 `left_click_drag`'s config overrides.
2913
2914 - `defer_loading: optional boolean or null`
2915
2916 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2917
2918 - `enabled: optional boolean or null`
2919
2920 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2921
2922 - `left_mouse_down: optional BetaComputerLeftMouseDownConfig or null`
2923
2924 `left_mouse_down`'s config overrides.
2925
2926 - `defer_loading: optional boolean or null`
2927
2928 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2929
2930 - `enabled: optional boolean or null`
2931
2932 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2933
2934 - `left_mouse_up: optional BetaComputerLeftMouseUpConfig or null`
2935
2936 `left_mouse_up`'s config overrides.
2937
2938 - `defer_loading: optional boolean or null`
2939
2940 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2941
2942 - `enabled: optional boolean or null`
2943
2944 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2945
2946 - `middle_click: optional BetaComputerMiddleClickConfig or null`
2947
2948 `middle_click`'s config overrides.
2949
2950 - `defer_loading: optional boolean or null`
2951
2952 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2953
2954 - `enabled: optional boolean or null`
2955
2956 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2957
2958 - `mouse_move: optional BetaComputerMouseMoveConfig or null`
2959
2960 `mouse_move`'s config overrides.
2961
2962 - `defer_loading: optional boolean or null`
2963
2964 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2965
2966 - `enabled: optional boolean or null`
2967
2968 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2969
2970 - `right_click: optional BetaComputerRightClickConfig or null`
2971
2972 `right_click`'s config overrides.
2973
2974 - `defer_loading: optional boolean or null`
2975
2976 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2977
2978 - `enabled: optional boolean or null`
2979
2980 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2981
2982 - `screenshot: optional BetaComputerScreenshotConfig or null`
2983
2984 `screenshot`'s config overrides.
2985
2986 - `defer_loading: optional boolean or null`
2987
2988 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2989
2990 - `enabled: optional boolean or null`
2991
2992 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2993
2994 - `scroll: optional BetaComputerScrollConfig or null`
2995
2996 `scroll`'s config overrides.
2997
2998 - `defer_loading: optional boolean or null`
2999
3000 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3001
3002 - `enabled: optional boolean or null`
3003
3004 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3005
3006 - `triple_click: optional BetaComputerTripleClickConfig or null`
3007
3008 `triple_click`'s config overrides.
3009
3010 - `defer_loading: optional boolean or null`
3011
3012 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3013
3014 - `enabled: optional boolean or null`
3015
3016 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3017
3018 - `type: optional BetaComputerTypeConfig or null`
3019
3020 `type`'s config overrides.
3021
3022 - `defer_loading: optional boolean or null`
3023
3024 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3025
3026 - `enabled: optional boolean or null`
3027
3028 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3029
3030 - `wait: optional BetaComputerWaitConfig or null`
3031
3032 `wait`'s config overrides.
3033
3034 - `defer_loading: optional boolean or null`
3035
3036 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3037
3038 - `enabled: optional boolean or null`
3039
3040 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3041
3042 - `zoom: optional BetaComputerZoomConfig or null`
3043
3044 `zoom`'s config overrides.
3045
3046 - `defer_loading: optional boolean or null`
3047
3048 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3049
3050 - `enabled: optional boolean or null`
3051
3052 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
22973053
22983054 - `BetaToolTextEditor20250124 object { name, type, allowed_callers, 4 more }`
22993055
from line 3790
30343790 "role": "user"
30353791 }
30363792 ],
3037 "model": "claude-opus-4-6",
3793 "model": "claude-opus-5",
30383794 "system": [
30393795 {
30403796 "text": "Today'\''s date is 2024-06-01.",
30413797
api/beta/messages/create Changed · +891 / -131 lines
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 21
2121
2222 - `string`
2323
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2525
2626 - `"message-batches-2024-09-24"`
2727
from line 66
6666 - `"output-300k-2026-03-24"`
6767
6868 - `"user-profiles-2026-03-24"`
69
70 - `"user-profiles-2026-08-18"`
6971
7072 - `"advisor-tool-2026-03-01"`
7173
from line 301
299301
300302 - `"search_result_location"`
301303
302 - `BetaImageBlockParam object { source, type, cache_control }`
304 - `BetaImageBlockParam object { source, type, cache_control, transformations }`
303305
304306 - `source: BetaBase64ImageSource or BetaURLImageSource or BetaFileImageSource`
305307
from line 347
345347
346348 Create a cache control breakpoint at this content block.
347349
350 - `transformations: optional BetaImageTransformationsParam or null`
351
352 Configures the transformations the server applies to this image before the model observes it. Each key names a condition the server transforms images for; its value selects the transformation applied. Omitted keys keep their default behavior, and an empty object is equivalent to omitting the field.
353
354 - `oversized_image: optional "downsize" or "error"`
355
356 What the server does when this image exceeds the model's maximum image size. `"downsize"` (the default) scales the image down to fit, which changes the dimensions the model observes without telling you. `"error"` instead rejects the request with a 400 error naming the image's dimensions and the largest dimensions that fit, so you can scale the image deliberately — your image is never silently scaled down.
357
358 - `"downsize"`
359
360 - `"error"`
361
348362 - `BetaRequestDocumentBlock object { source, type, cache_control, 3 more }`
349363
350364 - `source: BetaBase64PDFSource or BetaPlainTextSource or BetaContentBlockSource or 2 more`
from line 397
383397
384398 - `BetaTextBlockParam object { text, type, cache_control, citations }`
385399
386 - `BetaImageBlockParam object { source, type, cache_control }`
400 - `BetaImageBlockParam object { source, type, cache_control, transformations }`
387401
388402 - `type: "content"`
389403
from line 489
475489
476490 - `"redacted_thinking"`
477491
478 - `BetaToolUseBlockParam object { id, input, name, 3 more }`
492 - `BetaToolUseBlockParam object { id, input, name, 4 more }`
479493
480494 - `id: string`
481495
from line 535
521535
522536 - `"code_execution_20260120"`
523537
524 - `BetaToolResultBlockParam object { tool_use_id, type, cache_control, 2 more }`
538 - `toolset_name: optional string or null`
539
540 For a toolset member tool_use, the toolset family this member belongs to.
541
542 - `BetaToolResultBlockParam object { tool_use_id, type, cache_control, 3 more }`
525543
526544 - `tool_use_id: string`
527545
from line 551
533551
534552 Create a cache control breakpoint at this content block.
535553
536 - `content: optional string or array of BetaTextBlockParam or BetaImageBlockParam or BetaSearchResultBlockParam or 2 more`
554 - `content: optional string or array of BetaTextBlockParam or BetaImageBlockParam or BetaSearchResultBlockParam or 3 more`
537555
538556 - `string`
539557
540 - `array of BetaTextBlockParam or BetaImageBlockParam or BetaSearchResultBlockParam or 2 more`
558 - `array of BetaTextBlockParam or BetaImageBlockParam or BetaSearchResultBlockParam or 3 more`
541559
542560 - `BetaTextBlockParam object { text, type, cache_control, citations }`
543561
544 - `BetaImageBlockParam object { source, type, cache_control }`
562 - `BetaImageBlockParam object { source, type, cache_control, transformations }`
545563
546564 - `BetaSearchResultBlockParam object { content, source, title, 3 more }`
547565
from line 579
561579
562580 Create a cache control breakpoint at this content block.
563581
582 - `BetaBrowserStateBlockParam object { tabs, type, cache_control, state_changes }`
583
584 The caller's browser state after a browser toolset member call —
585 the full inventory of open tabs, which tab is active, and any side
586 effects (tabs opened, download state changes) the call produced.
587
588 At most one per `tool_result`, only on a non-error result answering a
589 browser toolset member `tool_use`. The server renders the
590 model-visible text from it; the model never sees the raw fields.
591
592 - `tabs: array of BetaBrowserStateTabEntry`
593
594 All tabs open in the browser after this call — the full inventory, not a delta. May be empty. Whenever non-empty, exactly one entry carries `active: true`.
595
596 - `tab_id: string`
597
598 The caller-assigned identifier for this tab, unique within the inventory.
599
600 - `title: string`
601
602 The title of the page the tab is showing. May be empty.
603
604 - `url: string`
605
606 The URL of the page the tab is showing. May be empty.
607
608 - `active: optional boolean`
609
610 Whether this tab is the active tab after this call. Whenever `tabs` is non-empty, exactly one entry is marked `active: true`.
611
612 - `type: "browser_state"`
613
614 - `"browser_state"`
615
616 - `cache_control: optional BetaCacheControlEphemeral or null`
617
618 Create a cache control breakpoint at this content block.
619
620 - `state_changes: optional array of BetaBrowserStateChange or null`
621
622 Tabs opened and download state changes during this call. "Nothing to report" is expressed by omitting the field, never by an empty list.
623
624 - `BetaBrowserStateChangeTabOpened object { tab_id, type }`
625
626 A tab this call's execution opened that remains open at its end —
627 the creation delta of the `tabs` inventory, not an event log.
628
629 Carries only the `tab_id`; the tab's `title` and `url` live on its
630 `tabs` entry, which must include the same `tab_id`. A tab opened
631 during a failed call gets no deferred `tab_opened`; it simply appears
632 in the next result's `tabs` inventory.
633
634 - `tab_id: string`
635
636 The `tab_id` of the opened tab, present in `tabs`.
637
638 - `type: "tab_opened"`
639
640 - `"tab_opened"`
641
642 - `BetaBrowserStateChangeDownloadStarted object { download_id, type, url }`
643
644 A file download that started during this call.
645
646 - `download_id: string`
647
648 The caller-assigned identifier for this download, stable across the state changes reporting it.
649
650 - `type: "download_started"`
651
652 - `"download_started"`
653
654 - `url: string`
655
656 The final post-redirect URL the download was served from.
657
658 - `BetaBrowserStateChangeDownloadCompleted object { download_id, type, url, 2 more }`
659
660 A file download that finished during this call, reported with the
661 same `download_id` as its `download_started` — or without a prior
662 `download_started`, when the download finished during the call that
663 started it (at most one state change per `download_id` per result).
664
665 - `download_id: string`
666
667 The caller-assigned identifier for this download, stable across the state changes reporting it.
668
669 - `type: "download_completed"`
670
671 - `"download_completed"`
672
673 - `url: string`
674
675 The final post-redirect URL the download was served from.
676
677 - `path: optional string or null`
678
679 Where the executor saved the file, on the executor's filesystem. Only included when another tool in the same environment can read the file at that path.
680
681 - `size_bytes: optional number or null`
682
683 The completed download's size.
684
685 - `BetaBrowserStateChangeDownloadFailed object { download_id, type, url, error }`
686
687 A file download that failed — or was cancelled — during this call.
688
689 - `download_id: string`
690
691 The caller-assigned identifier for this download, stable across the state changes reporting it.
692
693 - `type: "download_failed"`
694
695 - `"download_failed"`
696
697 - `url: string`
698
699 The final post-redirect URL the download was served from.
700
701 - `error: optional string or null`
702
703 The failure or cancellation detail, when known.
704
564705 - `is_error: optional boolean`
706
707 - `toolset_name: optional string or null`
708
709 For a toolset member tool_result, the toolset family of the paired tool_use.
565710
566711 - `BetaServerToolUseBlockParam object { id, input, name, 3 more }`
567712
from line 1286
11411286 - `encrypted_content: optional string or null`
11421287
11431288 Opaque metadata from prior compaction, to be round-tripped verbatim
1144
1145 - `BetaMidConversationSystemBlockParam object { content, type, cache_control }`
1146
1147 System instructions that appear mid-conversation.
1148
1149 Use this block to provide or update system-level instructions at a specific
1150 point in the conversation, rather than only via the top-level `system` parameter.
1151
1152 - `content: array of BetaTextBlockParam or BetaRequestToolAdditionBlock or BetaRequestToolRemovalBlock`
1153
1154 System instruction text blocks.
1155
1156 - `BetaTextBlockParam object { text, type, cache_control, citations }`
1157
1158 - `BetaRequestToolAdditionBlock object { tool, type, cache_control }`
1159
1160 Mid-conversation directive to surface a declared tool.
1161
1162 `tool` references a tool (or MCP toolset) by name from the request's
1163 `tools`; it is offered to the model from this point in the
1164 conversation onward.
1165
1166 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`
1167
1168 Reference to a single tool the caller declared directly in
1169 `tools[]`. Does not accept the composed `{server}_{name}` form the
1170 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1171 `mcp_toolset_reference` for those.
1172
1173 - `BetaToolChangeToolReference object { name, type }`
1174
1175 Reference to a single tool the caller declared directly in
1176 `tools[]`. Does not accept the composed `{server}_{name}` form the
1177 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1178 `mcp_toolset_reference` for those.
1179
1180 - `name: string`
1181
1182 - `type: "tool_reference"`
1183
1184 - `"tool_reference"`
1185
1186 - `BetaToolChangeMCPToolReference object { name, server_name, type }`
1187
1188 Reference to a single MCP tool by its server and remote name — the
1189 same `server_name`/`name` pair `mcp_tool_use` carries.
1190
1191 - `name: string`
1192
1193 - `server_name: string`
1194
1195 - `type: "mcp_tool_reference"`
1196
1197 - `"mcp_tool_reference"`
1198
1199 - `BetaToolChangeMCPToolsetReference object { server_name, type }`
1200
1201 Reference to every tool in the named MCP server's toolset.
1202
1203 - `server_name: string`
1204
1205 - `type: "mcp_toolset_reference"`
1206
1207 - `"mcp_toolset_reference"`
1208
1209 - `type: "tool_addition"`
1210
1211 - `"tool_addition"`
1212
1213 - `cache_control: optional BetaCacheControlEphemeral or null`
1214
1215 Create a cache control breakpoint at this content block.
1216
1217 - `BetaRequestToolRemovalBlock object { tool, type, cache_control }`
1218
1219 Mid-conversation directive to withdraw a tool.
1220
1221 `tool` references a tool (or MCP toolset) by name from the request's
1222 `tools`; it is no longer offered to the model from this point in the
1223 conversation onward.
1224
1225 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`
1226
1227 Reference to a single tool the caller declared directly in
1228 `tools[]`. Does not accept the composed `{server}_{name}` form the
1229 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1230 `mcp_toolset_reference` for those.
1231
1232 - `BetaToolChangeToolReference object { name, type }`
1233
1234 Reference to a single tool the caller declared directly in
1235 `tools[]`. Does not accept the composed `{server}_{name}` form the
1236 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1237 `mcp_toolset_reference` for those.
1238
1239 - `BetaToolChangeMCPToolReference object { name, server_name, type }`
1240
1241 Reference to a single MCP tool by its server and remote name — the
1242 same `server_name`/`name` pair `mcp_tool_use` carries.
1243
1244 - `BetaToolChangeMCPToolsetReference object { server_name, type }`
1245
1246 Reference to every tool in the named MCP server's toolset.
1247
1248 - `type: "tool_removal"`
1249
1250 - `"tool_removal"`
1251
1252 - `cache_control: optional BetaCacheControlEphemeral or null`
1253
1254 Create a cache control breakpoint at this content block.
1255
1256 - `type: "mid_conv_system"`
1257
1258 - `"mid_conv_system"`
1259
1260 - `cache_control: optional BetaCacheControlEphemeral or null`
1261
1262 Create a cache control breakpoint at this content block.
12631289
12641290 - `BetaRequestToolAdditionBlock object { tool, type, cache_control }`
12651291
from line 1295
12691295 `tools`; it is offered to the model from this point in the
12701296 conversation onward.
12711297
1298 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`
1299
1300 Reference to a single tool the caller declared directly in
1301 `tools[]`. Does not accept the composed `{server}_{name}` form the
1302 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1303 `mcp_toolset_reference` for those.
1304
1305 - `BetaToolChangeToolReference object { name, type }`
1306
1307 Reference to a single tool the caller declared directly in
1308 `tools[]`. Does not accept the composed `{server}_{name}` form the
1309 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1310 `mcp_toolset_reference` for those.
1311
1312 - `name: string`
1313
1314 - `type: "tool_reference"`
1315
1316 - `"tool_reference"`
1317
1318 - `BetaToolChangeMCPToolReference object { name, server_name, type }`
1319
1320 Reference to a single MCP tool by its server and remote name — the
1321 same `server_name`/`name` pair `mcp_tool_use` carries.
1322
1323 - `name: string`
1324
1325 - `server_name: string`
1326
1327 - `type: "mcp_tool_reference"`
1328
1329 - `"mcp_tool_reference"`
1330
1331 - `BetaToolChangeMCPToolsetReference object { server_name, type }`
1332
1333 Reference to every tool in the named MCP server's toolset.
1334
1335 - `server_name: string`
1336
1337 - `type: "mcp_toolset_reference"`
1338
1339 - `"mcp_toolset_reference"`
1340
1341 - `type: "tool_addition"`
1342
1343 - `"tool_addition"`
1344
1345 - `cache_control: optional BetaCacheControlEphemeral or null`
1346
1347 Create a cache control breakpoint at this content block.
1348
12721349 - `BetaRequestToolRemovalBlock object { tool, type, cache_control }`
12731350
12741351 Mid-conversation directive to withdraw a tool.
from line 1353
12761353 `tool` references a tool (or MCP toolset) by name from the request's
12771354 `tools`; it is no longer offered to the model from this point in the
12781355 conversation onward.
1356
1357 - `tool: BetaToolChangeToolReference or BetaToolChangeMCPToolReference or BetaToolChangeMCPToolsetReference`
1358
1359 Reference to a single tool the caller declared directly in
1360 `tools[]`. Does not accept the composed `{server}_{name}` form the
1361 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1362 `mcp_toolset_reference` for those.
1363
1364 - `BetaToolChangeToolReference object { name, type }`
1365
1366 Reference to a single tool the caller declared directly in
1367 `tools[]`. Does not accept the composed `{server}_{name}` form the
1368 server assigns to MCP-resolved tools — use `mcp_tool_reference` or
1369 `mcp_toolset_reference` for those.
1370
1371 - `BetaToolChangeMCPToolReference object { name, server_name, type }`
1372
1373 Reference to a single MCP tool by its server and remote name — the
1374 same `server_name`/`name` pair `mcp_tool_use` carries.
1375
1376 - `BetaToolChangeMCPToolsetReference object { server_name, type }`
1377
1378 Reference to every tool in the named MCP server's toolset.
1379
1380 - `type: "tool_removal"`
1381
1382 - `"tool_removal"`
1383
1384 - `cache_control: optional BetaCacheControlEphemeral or null`
1385
1386 Create a cache control breakpoint at this content block.
12791387
12801388 - `BetaFallbackBlockParam object { from, to, type, trigger }`
12811389
from line 2355
22472355
22482356 When true, guarantees schema validation on tool names and inputs
22492357
2358 - `BetaBrowserToolset20260801 object { type, allowed_callers, cache_control, configs }`
2359
2360 The browser toolset: a single `tools[]` entry (carrying no
2361 `name`) that declares the browser tool family. The model is served
2362 the family's tool with any members disabled via `configs` removed
2363 from its schema.
2364
2365 - `type: "browser_toolset_20260801"`
2366
2367 - `"browser_toolset_20260801"`
2368
2369 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2370
2371 - `"direct"`
2372
2373 - `"code_execution_20250825"`
2374
2375 - `"code_execution_20260120"`
2376
2377 - `"code_execution_20260521"`
2378
2379 - `cache_control: optional BetaCacheControlEphemeral or null`
2380
2381 Create a cache control breakpoint at this content block.
2382
2383 - `configs: optional BetaBrowserToolsetConfigs or null`
2384
2385 Per-member configuration for `browser_toolset_20260801`: one
2386 optional field per member tool, keyed by the member name — the same
2387 name the member's `tool_use` blocks carry. Every member is an
2388 accepted key, and a member's defaults apply wherever its key is
2389 absent. Unknown keys are rejected: the field set is this toolset
2390 version's complete member set.
2391
2392 - `close_tab: optional BetaBrowserCloseTabConfig or null`
2393
2394 `close_tab`'s config overrides.
2395
2396 - `defer_loading: optional boolean or null`
2397
2398 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2399
2400 - `enabled: optional boolean or null`
2401
2402 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2403
2404 - `double_click: optional BetaBrowserDoubleClickConfig or null`
2405
2406 `double_click`'s config overrides.
2407
2408 - `defer_loading: optional boolean or null`
2409
2410 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2411
2412 - `enabled: optional boolean or null`
2413
2414 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2415
2416 - `file_upload: optional BetaBrowserFileUploadConfig or null`
2417
2418 `file_upload`'s config overrides.
2419
2420 - `defer_loading: optional boolean or null`
2421
2422 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2423
2424 - `enabled: optional boolean or null`
2425
2426 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2427
2428 - `find: optional BetaBrowserFindConfig or null`
2429
2430 `find`'s config overrides.
2431
2432 - `defer_loading: optional boolean or null`
2433
2434 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2435
2436 - `enabled: optional boolean or null`
2437
2438 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2439
2440 - `form_input: optional BetaBrowserFormInputConfig or null`
2441
2442 `form_input`'s config overrides.
2443
2444 - `defer_loading: optional boolean or null`
2445
2446 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2447
2448 - `enabled: optional boolean or null`
2449
2450 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2451
2452 - `get_page_text: optional BetaBrowserGetPageTextConfig or null`
2453
2454 `get_page_text`'s config overrides.
2455
2456 - `defer_loading: optional boolean or null`
2457
2458 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2459
2460 - `enabled: optional boolean or null`
2461
2462 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2463
2464 - `hold_key: optional BetaBrowserHoldKeyConfig or null`
2465
2466 `hold_key`'s config overrides.
2467
2468 - `defer_loading: optional boolean or null`
2469
2470 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2471
2472 - `enabled: optional boolean or null`
2473
2474 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2475
2476 - `hover: optional BetaBrowserHoverConfig or null`
2477
2478 `hover`'s config overrides.
2479
2480 - `defer_loading: optional boolean or null`
2481
2482 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2483
2484 - `enabled: optional boolean or null`
2485
2486 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2487
2488 - `javascript_exec: optional BetaBrowserJavascriptExecConfig or null`
2489
2490 `javascript_exec`'s config overrides.
2491
2492 - `defer_loading: optional boolean or null`
2493
2494 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2495
2496 - `enabled: optional boolean or null`
2497
2498 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2499
2500 - `key: optional BetaBrowserKeyConfig or null`
2501
2502 `key`'s config overrides.
2503
2504 - `defer_loading: optional boolean or null`
2505
2506 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2507
2508 - `enabled: optional boolean or null`
2509
2510 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2511
2512 - `left_click: optional BetaBrowserLeftClickConfig or null`
2513
2514 `left_click`'s config overrides.
2515
2516 - `defer_loading: optional boolean or null`
2517
2518 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2519
2520 - `enabled: optional boolean or null`
2521
2522 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2523
2524 - `left_click_drag: optional BetaBrowserLeftClickDragConfig or null`
2525
2526 `left_click_drag`'s config overrides.
2527
2528 - `defer_loading: optional boolean or null`
2529
2530 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2531
2532 - `enabled: optional boolean or null`
2533
2534 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2535
2536 - `left_mouse_down: optional BetaBrowserLeftMouseDownConfig or null`
2537
2538 `left_mouse_down`'s config overrides.
2539
2540 - `defer_loading: optional boolean or null`
2541
2542 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2543
2544 - `enabled: optional boolean or null`
2545
2546 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2547
2548 - `left_mouse_up: optional BetaBrowserLeftMouseUpConfig or null`
2549
2550 `left_mouse_up`'s config overrides.
2551
2552 - `defer_loading: optional boolean or null`
2553
2554 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2555
2556 - `enabled: optional boolean or null`
2557
2558 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2559
2560 - `list_tabs: optional BetaBrowserListTabsConfig or null`
2561
2562 `list_tabs`'s config overrides.
2563
2564 - `defer_loading: optional boolean or null`
2565
2566 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2567
2568 - `enabled: optional boolean or null`
2569
2570 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2571
2572 - `middle_click: optional BetaBrowserMiddleClickConfig or null`
2573
2574 `middle_click`'s config overrides.
2575
2576 - `defer_loading: optional boolean or null`
2577
2578 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2579
2580 - `enabled: optional boolean or null`
2581
2582 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2583
2584 - `mouse_move: optional BetaBrowserMouseMoveConfig or null`
2585
2586 `mouse_move`'s config overrides.
2587
2588 - `defer_loading: optional boolean or null`
2589
2590 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2591
2592 - `enabled: optional boolean or null`
2593
2594 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2595
2596 - `navigate: optional BetaBrowserNavigateConfig or null`
2597
2598 `navigate`'s config overrides.
2599
2600 - `defer_loading: optional boolean or null`
2601
2602 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2603
2604 - `enabled: optional boolean or null`
2605
2606 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2607
2608 - `new_tab: optional BetaBrowserNewTabConfig or null`
2609
2610 `new_tab`'s config overrides.
2611
2612 - `defer_loading: optional boolean or null`
2613
2614 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2615
2616 - `enabled: optional boolean or null`
2617
2618 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2619
2620 - `read_console: optional BetaBrowserReadConsoleConfig or null`
2621
2622 `read_console`'s config overrides.
2623
2624 - `defer_loading: optional boolean or null`
2625
2626 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2627
2628 - `enabled: optional boolean or null`
2629
2630 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2631
2632 - `read_network: optional BetaBrowserReadNetworkConfig or null`
2633
2634 `read_network`'s config overrides.
2635
2636 - `defer_loading: optional boolean or null`
2637
2638 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2639
2640 - `enabled: optional boolean or null`
2641
2642 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2643
2644 - `read_page: optional BetaBrowserReadPageConfig or null`
2645
2646 `read_page`'s config overrides.
2647
2648 - `defer_loading: optional boolean or null`
2649
2650 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2651
2652 - `enabled: optional boolean or null`
2653
2654 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2655
2656 - `right_click: optional BetaBrowserRightClickConfig or null`
2657
2658 `right_click`'s config overrides.
2659
2660 - `defer_loading: optional boolean or null`
2661
2662 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2663
2664 - `enabled: optional boolean or null`
2665
2666 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2667
2668 - `screenshot: optional BetaBrowserScreenshotConfig or null`
2669
2670 `screenshot`'s config overrides.
2671
2672 - `defer_loading: optional boolean or null`
2673
2674 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2675
2676 - `enabled: optional boolean or null`
2677
2678 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2679
2680 - `scroll: optional BetaBrowserScrollConfig or null`
2681
2682 `scroll`'s config overrides.
2683
2684 - `defer_loading: optional boolean or null`
2685
2686 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2687
2688 - `enabled: optional boolean or null`
2689
2690 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2691
2692 - `scroll_to: optional BetaBrowserScrollToConfig or null`
2693
2694 `scroll_to`'s config overrides.
2695
2696 - `defer_loading: optional boolean or null`
2697
2698 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2699
2700 - `enabled: optional boolean or null`
2701
2702 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2703
2704 - `switch_tab: optional BetaBrowserSwitchTabConfig or null`
2705
2706 `switch_tab`'s config overrides.
2707
2708 - `defer_loading: optional boolean or null`
2709
2710 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2711
2712 - `enabled: optional boolean or null`
2713
2714 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2715
2716 - `triple_click: optional BetaBrowserTripleClickConfig or null`
2717
2718 `triple_click`'s config overrides.
2719
2720 - `defer_loading: optional boolean or null`
2721
2722 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2723
2724 - `enabled: optional boolean or null`
2725
2726 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2727
2728 - `type: optional BetaBrowserTypeConfig or null`
2729
2730 `type`'s config overrides.
2731
2732 - `defer_loading: optional boolean or null`
2733
2734 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2735
2736 - `enabled: optional boolean or null`
2737
2738 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2739
2740 - `wait: optional BetaBrowserWaitConfig or null`
2741
2742 `wait`'s config overrides.
2743
2744 - `defer_loading: optional boolean or null`
2745
2746 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2747
2748 - `enabled: optional boolean or null`
2749
2750 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2751
2752 - `zoom: optional BetaBrowserZoomConfig or null`
2753
2754 `zoom`'s config overrides.
2755
2756 - `defer_loading: optional boolean or null`
2757
2758 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2759
2760 - `enabled: optional boolean or null`
2761
2762 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
2763
22502764 - `BetaToolComputerUse20241022 object { display_height_px, display_width_px, name, 7 more }`
22512765
22522766 - `display_height_px: number`
from line 2990
24762990 - `strict: optional boolean`
24772991
24782992 When true, guarantees schema validation on tool names and inputs
2993
2994 - `BetaComputerToolset20260801 object { type, allowed_callers, cache_control, configs }`
2995
2996 The computer toolset: a single `tools[]` entry (carrying no
2997 `name`) that declares the computer tool family. The model is
2998 served the family's tool with any members disabled via `configs`
2999 removed from its schema. Every member is enabled by default, zoom
3000 included. The single-tool options `display_number` and
3001 `enable_zoom` are not fields of a toolset entry — it carries only
3002 `type`, `configs`, and `cache_control`; zoom is controlled
3003 via `configs.zoom.enabled`.
3004
3005 - `type: "computer_toolset_20260801"`
3006
3007 - `"computer_toolset_20260801"`
3008
3009 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
3010
3011 - `"direct"`
3012
3013 - `"code_execution_20250825"`
3014
3015 - `"code_execution_20260120"`
3016
3017 - `"code_execution_20260521"`
3018
3019 - `cache_control: optional BetaCacheControlEphemeral or null`
3020
3021 Create a cache control breakpoint at this content block.
3022
3023 - `configs: optional BetaComputerToolsetConfigs or null`
3024
3025 Per-member configuration for `computer_toolset_20260801`: one
3026 optional field per member tool, keyed by the member name — the same
3027 name the member's `tool_use` blocks carry. Every member is an
3028 accepted key, and a member's defaults apply wherever its key is
3029 absent. Unknown keys are rejected: the field set is this toolset
3030 version's complete member set.
3031
3032 - `cursor_position: optional BetaComputerCursorPositionConfig or null`
3033
3034 `cursor_position`'s config overrides.
3035
3036 - `defer_loading: optional boolean or null`
3037
3038 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3039
3040 - `enabled: optional boolean or null`
3041
3042 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3043
3044 - `double_click: optional BetaComputerDoubleClickConfig or null`
3045
3046 `double_click`'s config overrides.
3047
3048 - `defer_loading: optional boolean or null`
3049
3050 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3051
3052 - `enabled: optional boolean or null`
3053
3054 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3055
3056 - `hold_key: optional BetaComputerHoldKeyConfig or null`
3057
3058 `hold_key`'s config overrides.
3059
3060 - `defer_loading: optional boolean or null`
3061
3062 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3063
3064 - `enabled: optional boolean or null`
3065
3066 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3067
3068 - `key: optional BetaComputerKeyConfig or null`
3069
3070 `key`'s config overrides.
3071
3072 - `defer_loading: optional boolean or null`
3073
3074 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3075
3076 - `enabled: optional boolean or null`
3077
3078 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3079
3080 - `left_click: optional BetaComputerLeftClickConfig or null`
3081
3082 `left_click`'s config overrides.
3083
3084 - `defer_loading: optional boolean or null`
3085
3086 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3087
3088 - `enabled: optional boolean or null`
3089
3090 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3091
3092 - `left_click_drag: optional BetaComputerLeftClickDragConfig or null`
3093
3094 `left_click_drag`'s config overrides.
3095
3096 - `defer_loading: optional boolean or null`
3097
3098 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3099
3100 - `enabled: optional boolean or null`
3101
3102 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3103
3104 - `left_mouse_down: optional BetaComputerLeftMouseDownConfig or null`
3105
3106 `left_mouse_down`'s config overrides.
3107
3108 - `defer_loading: optional boolean or null`
3109
3110 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3111
3112 - `enabled: optional boolean or null`
3113
3114 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3115
3116 - `left_mouse_up: optional BetaComputerLeftMouseUpConfig or null`
3117
3118 `left_mouse_up`'s config overrides.
3119
3120 - `defer_loading: optional boolean or null`
3121
3122 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3123
3124 - `enabled: optional boolean or null`
3125
3126 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3127
3128 - `middle_click: optional BetaComputerMiddleClickConfig or null`
3129
3130 `middle_click`'s config overrides.
3131
3132 - `defer_loading: optional boolean or null`
3133
3134 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3135
3136 - `enabled: optional boolean or null`
3137
3138 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3139
3140 - `mouse_move: optional BetaComputerMouseMoveConfig or null`
3141
3142 `mouse_move`'s config overrides.
3143
3144 - `defer_loading: optional boolean or null`
3145
3146 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3147
3148 - `enabled: optional boolean or null`
3149
3150 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3151
3152 - `right_click: optional BetaComputerRightClickConfig or null`
3153
3154 `right_click`'s config overrides.
3155
3156 - `defer_loading: optional boolean or null`
3157
3158 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3159
3160 - `enabled: optional boolean or null`
3161
3162 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3163
3164 - `screenshot: optional BetaComputerScreenshotConfig or null`
3165
3166 `screenshot`'s config overrides.
3167
3168 - `defer_loading: optional boolean or null`
3169
3170 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3171
3172 - `enabled: optional boolean or null`
3173
3174 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3175
3176 - `scroll: optional BetaComputerScrollConfig or null`
3177
3178 `scroll`'s config overrides.
3179
3180 - `defer_loading: optional boolean or null`
3181
3182 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3183
3184 - `enabled: optional boolean or null`
3185
3186 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3187
3188 - `triple_click: optional BetaComputerTripleClickConfig or null`
3189
3190 `triple_click`'s config overrides.
3191
3192 - `defer_loading: optional boolean or null`
3193
3194 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3195
3196 - `enabled: optional boolean or null`
3197
3198 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3199
3200 - `type: optional BetaComputerTypeConfig or null`
3201
3202 `type`'s config overrides.
3203
3204 - `defer_loading: optional boolean or null`
3205
3206 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3207
3208 - `enabled: optional boolean or null`
3209
3210 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3211
3212 - `wait: optional BetaComputerWaitConfig or null`
3213
3214 `wait`'s config overrides.
3215
3216 - `defer_loading: optional boolean or null`
3217
3218 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3219
3220 - `enabled: optional boolean or null`
3221
3222 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
3223
3224 - `zoom: optional BetaComputerZoomConfig or null`
3225
3226 `zoom`'s config overrides.
3227
3228 - `defer_loading: optional boolean or null`
3229
3230 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
3231
3232 - `enabled: optional boolean or null`
3233
3234 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enabled resolves false is withheld from the served schema.
24793235
24803236 - `BetaToolTextEditor20250124 object { name, type, allowed_callers, 4 more }`
24813237
from line 4185
34294185
34304186 - `"redacted_thinking"`
34314187
3432 - `BetaToolUseBlock object { id, input, name, 2 more }`
4188 - `BetaToolUseBlock object { id, input, name, 3 more }`
34334189
34344190 - `id: string`
34354191
from line 4226
34704226 - `type: "code_execution_20260120"`
34714227
34724228 - `"code_execution_20260120"`
4229
4230 - `toolset_name: optional string or null`
4231
4232 For a toolset member tool_use, the toolset family.
34734233
34744234 - `BetaServerToolUseBlock object { id, input, name, 2 more }`
34754235
from line 5520
47605520 "role": "user"
47615521 }
47625522 ],
4763 "model": "claude-opus-4-6",
5523 "model": "claude-opus-5",
47645524 "stream": false,
47655525 "system": [
47665526 {
from line 5600
48405600 "type": "model_changed"
48415601 }
48425602 },
4843 "model": "claude-opus-4-6",
5603 "model": "claude-opus-5",
48445604 "role": "assistant",
48455605 "stop_details": {
48465606 "category": "cyber",
48475607 "explanation": "This request was declined because it conflicts with Anthropic's Usage Policy.",
48485608 "fallback_credit_token": "QW50aHJvcGljL0NsYXVkZQ==",
48495609 "fallback_has_prefill_claim": true,
4850 "recommended_model": "claude-sonnet-4-6",
5610 "recommended_model": "claude-opus-4-8",
48515611 "type": "refusal"
48525612 },
48535613 "stop_reason": "end_turn",
48545614
api/beta/models Changed · +12 / -8 lines
from line 37
3737
3838 - `string`
3939
40 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
40 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
4141
4242 - `"message-batches-2024-09-24"`
4343
from line 83
8383
8484 - `"user-profiles-2026-03-24"`
8585
86 - `"user-profiles-2026-08-18"`
87
8688 - `"advisor-tool-2026-03-01"`
8789
8890 - `"managed-agents-2026-04-01"`
from line 269
267269{
268270 "data": [
269271 {
270 "id": "claude-opus-4-6",
272 "id": "claude-opus-5",
271273 "allowed_fallback_models": [
272274 "string"
273275 ],
from line 334
332334 }
333335 }
334336 },
335 "created_at": "2026-02-04T00:00:00Z",
336 "display_name": "Claude Opus 4.6",
337 "created_at": "2026-07-24T00:00:00Z",
338 "display_name": "Claude Opus 5",
337339 "max_input_tokens": 0,
338340 "max_tokens": 0,
339341 "type": "model"
from line 369
367369
368370 - `string`
369371
370 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
372 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
371373
372374 - `"message-batches-2024-09-24"`
373375
from line 415
413415
414416 - `"user-profiles-2026-03-24"`
415417
418 - `"user-profiles-2026-08-18"`
419
416420 - `"advisor-tool-2026-03-01"`
417421
418422 - `"managed-agents-2026-04-01"`
from line 587
583587
584588```json
585589{
586 "id": "claude-opus-4-6",
590 "id": "claude-opus-5",
587591 "allowed_fallback_models": [
588592 "string"
589593 ],
from line 652
648652 }
649653 }
650654 },
651 "created_at": "2026-02-04T00:00:00Z",
652 "display_name": "Claude Opus 4.6",
655 "created_at": "2026-07-24T00:00:00Z",
656 "display_name": "Claude Opus 5",
653657 "max_input_tokens": 0,
654658 "max_tokens": 0,
655659 "type": "model"
api/beta/models/list Changed · +6 / -4 lines
from line 35
3535
3636 - `string`
3737
38 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
38 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
3939
4040 - `"message-batches-2024-09-24"`
4141
from line 81
8181
8282 - `"user-profiles-2026-03-24"`
8383
84 - `"user-profiles-2026-08-18"`
85
8486 - `"advisor-tool-2026-03-01"`
8587
8688 - `"managed-agents-2026-04-01"`
from line 267
265267{
266268 "data": [
267269 {
268 "id": "claude-opus-4-6",
270 "id": "claude-opus-5",
269271 "allowed_fallback_models": [
270272 "string"
271273 ],
from line 332
330332 }
331333 }
332334 },
333 "created_at": "2026-02-04T00:00:00Z",
334 "display_name": "Claude Opus 4.6",
335 "created_at": "2026-07-24T00:00:00Z",
336 "display_name": "Claude Opus 5",
335337 "max_input_tokens": 0,
336338 "max_tokens": 0,
337339 "type": "model"
api/beta/models/retrieve Changed · +6 / -4 lines
from line 25
2525
2626 - `string`
2727
28 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
28 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2929
3030 - `"message-batches-2024-09-24"`
3131
from line 71
7171
7272 - `"user-profiles-2026-03-24"`
7373
74 - `"user-profiles-2026-08-18"`
75
7476 - `"advisor-tool-2026-03-01"`
7577
7678 - `"managed-agents-2026-04-01"`
from line 243
241243
242244```json
243245{
244 "id": "claude-opus-4-6",
246 "id": "claude-opus-5",
245247 "allowed_fallback_models": [
246248 "string"
247249 ],
from line 308
306308 }
307309 }
308310 },
309 "created_at": "2026-02-04T00:00:00Z",
310 "display_name": "Claude Opus 4.6",
311 "created_at": "2026-07-24T00:00:00Z",
312 "display_name": "Claude Opus 5",
311313 "max_input_tokens": 0,
312314 "max_tokens": 0,
313315 "type": "model"
api/beta/sessions Changed · +72 / -34 lines
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 19
1919
2020 - `string`
2121
22 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
22 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2323
2424 - `"message-batches-2024-09-24"`
2525
from line 65
6565
6666 - `"user-profiles-2026-03-24"`
6767
68 - `"user-profiles-2026-08-18"`
69
6870 - `"advisor-tool-2026-03-01"`
6971
7072 - `"managed-agents-2026-04-01"`
from line 143
141143
142144 - `model: optional BetaManagedAgentsModel or BetaManagedAgentsModelConfigParams`
143145
144 Replacement model. Accepts the model string, e.g. `claude-opus-4-6`, or a `model_config` object. Omit to use the agent's model.
146 Replacement model. Accepts the model string, e.g. `claude-opus-5`, or a `model_config` object. Omit to use the agent's model.
145147
146148 - `BetaManagedAgentsModel = "claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more or string`
147149
from line 1522
15201522 }
15211523 ],
15221524 "model": {
1523 "id": "claude-sonnet-4-6",
1525 "id": "claude-opus-5",
15241526 "effort": {
15251527 "type": "low"
15261528 },
from line 1542
15401542 }
15411543 ],
15421544 "model": {
1543 "id": "claude-sonnet-4-6",
1545 "id": "claude-opus-5",
15441546 "effort": {
15451547 "type": "low"
15461548 },
from line 1778
17761778
17771779 - `string`
17781780
1779 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
1781 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
17801782
17811783 - `"message-batches-2024-09-24"`
17821784
from line 1824
18221824
18231825 - `"user-profiles-2026-03-24"`
18241826
1827 - `"user-profiles-2026-08-18"`
1828
18251829 - `"advisor-tool-2026-03-01"`
18261830
18271831 - `"managed-agents-2026-04-01"`
from line 2539
25352539 }
25362540 ],
25372541 "model": {
2538 "id": "claude-sonnet-4-6",
2542 "id": "claude-opus-5",
25392543 "effort": {
25402544 "type": "low"
25412545 },
from line 2559
25552559 }
25562560 ],
25572561 "model": {
2558 "id": "claude-sonnet-4-6",
2562 "id": "claude-opus-5",
25592563 "effort": {
25602564 "type": "low"
25612565 },
from line 2737
27332737
27342738 - `string`
27352739
2736 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
2740 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
27372741
27382742 - `"message-batches-2024-09-24"`
27392743
from line 2783
27792783
27802784 - `"user-profiles-2026-03-24"`
27812785
2786 - `"user-profiles-2026-08-18"`
2787
27822788 - `"advisor-tool-2026-03-01"`
27832789
27842790 - `"managed-agents-2026-04-01"`
from line 3488
34823488 }
34833489 ],
34843490 "model": {
3485 "id": "claude-sonnet-4-6",
3491 "id": "claude-opus-5",
34863492 "effort": {
34873493 "type": "low"
34883494 },
from line 3508
35023508 }
35033509 ],
35043510 "model": {
3505 "id": "claude-sonnet-4-6",
3511 "id": "claude-opus-5",
35063512 "effort": {
35073513 "type": "low"
35083514 },
from line 3682
36763682
36773683 - `string`
36783684
3679 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
3685 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
36803686
36813687 - `"message-batches-2024-09-24"`
36823688
from line 3728
37223728
37233729 - `"user-profiles-2026-03-24"`
37243730
3731 - `"user-profiles-2026-08-18"`
3732
37253733 - `"advisor-tool-2026-03-01"`
37263734
37273735 - `"managed-agents-2026-04-01"`
from line 4657
46494657 }
46504658 ],
46514659 "model": {
4652 "id": "claude-sonnet-4-6",
4660 "id": "claude-opus-5",
46534661 "effort": {
46544662 "type": "low"
46554663 },
from line 4677
46694677 }
46704678 ],
46714679 "model": {
4672 "id": "claude-sonnet-4-6",
4680 "id": "claude-opus-5",
46734681 "effort": {
46744682 "type": "low"
46754683 },
from line 4851
48434851
48444852 - `string`
48454853
4846 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
4854 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
48474855
48484856 - `"message-batches-2024-09-24"`
48494857
from line 4897
48894897
48904898 - `"user-profiles-2026-03-24"`
48914899
4900 - `"user-profiles-2026-08-18"`
4901
48924902 - `"advisor-tool-2026-03-01"`
48934903
48944904 - `"managed-agents-2026-04-01"`
from line 4970
49604970
49614971 - `string`
49624972
4963 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
4973 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
49644974
49654975 - `"message-batches-2024-09-24"`
49664976
from line 5016
50065016
50075017 - `"user-profiles-2026-03-24"`
50085018
5019 - `"user-profiles-2026-08-18"`
5020
50095021 - `"advisor-tool-2026-03-01"`
50105022
50115023 - `"managed-agents-2026-04-01"`
from line 5722
57105722 }
57115723 ],
57125724 "model": {
5713 "id": "claude-sonnet-4-6",
5725 "id": "claude-opus-5",
57145726 "effort": {
57155727 "type": "low"
57165728 },
from line 5742
57305742 }
57315743 ],
57325744 "model": {
5733 "id": "claude-sonnet-4-6",
5745 "id": "claude-opus-5",
57345746 "effort": {
57355747 "type": "low"
57365748 },
from line 5988
59765988
59775989 - `model: optional BetaManagedAgentsModel or BetaManagedAgentsModelConfigParams`
59785990
5979 Replacement model. Accepts the model string, e.g. `claude-opus-4-6`, or a `model_config` object. Omit to use the agent's model.
5991 Replacement model. Accepts the model string, e.g. `claude-opus-5`, or a `model_config` object. Omit to use the agent's model.
59805992
59815993 - `BetaManagedAgentsModel = "claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more or string`
59825994
from line 9316
93049316
93059317 - `string`
93069318
9307 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
9319 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
93089320
93099321 - `"message-batches-2024-09-24"`
93109322
from line 9362
93509362
93519363 - `"user-profiles-2026-03-24"`
93529364
9365 - `"user-profiles-2026-08-18"`
9366
93539367 - `"advisor-tool-2026-03-01"`
93549368
93559369 - `"managed-agents-2026-04-01"`
from line 9572
95589572
95599573 - `type: "user.interrupt"`
95609574
9561 - `"user.interrupt"`
9562
9563 - `processed_at: optional string or null`
9564
9565 A timestamp in RFC 3339 format
9566
9567 - `session_thread_id: optional string or null`
9568
9569 If absent, interrupts every non-archived thread
9575 - `"u
api/beta/sessions/archive Changed · +5 / -3 lines
from line 21
2121
2222 - `string`
2323
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2525
2626 - `"message-batches-2024-09-24"`
2727
from line 67
6767
6868 - `"user-profiles-2026-03-24"`
6969
70 - `"user-profiles-2026-08-18"`
71
7072 - `"advisor-tool-2026-03-01"`
7173
7274 - `"managed-agents-2026-04-01"`
from line 773
771773 }
772774 ],
773775 "model": {
774 "id": "claude-sonnet-4-6",
776 "id": "claude-opus-5",
775777 "effort": {
776778 "type": "low"
777779 },
from line 793
791793 }
792794 ],
793795 "model": {
794 "id": "claude-sonnet-4-6",
796 "id": "claude-opus-5",
795797 "effort": {
796798 "type": "low"
797799 },
api/beta/sessions/create Changed · +6 / -4 lines
from line 17
1717
1818 - `string`
1919
20 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
20 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2121
2222 - `"message-batches-2024-09-24"`
2323
from line 63
6363
6464 - `"user-profiles-2026-03-24"`
6565
66 - `"user-profiles-2026-08-18"`
67
6668 - `"advisor-tool-2026-03-01"`
6769
6870 - `"managed-agents-2026-04-01"`
from line 141
139141
140142 - `model: optional BetaManagedAgentsModel or BetaManagedAgentsModelConfigParams`
141143
142 Replacement model. Accepts the model string, e.g. `claude-opus-4-6`, or a `model_config` object. Omit to use the agent's model.
144 Replacement model. Accepts the model string, e.g. `claude-opus-5`, or a `model_config` object. Omit to use the agent's model.
143145
144146 - `BetaManagedAgentsModel = "claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more or string`
145147
from line 1520
15181520 }
15191521 ],
15201522 "model": {
1521 "id": "claude-sonnet-4-6",
1523 "id": "claude-opus-5",
15221524 "effort": {
15231525 "type": "low"
15241526 },
from line 1540
15381540 }
15391541 ],
15401542 "model": {
1541 "id": "claude-sonnet-4-6",
1543 "id": "claude-opus-5",
15421544 "effort": {
15431545 "type": "low"
15441546 },
api/beta/sessions/events Changed · +9 / -3 lines
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 61
6161
6262 - `string`
6363
64 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
64 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
6565
6666 - `"message-batches-2024-09-24"`
6767
from line 107
107107
108108 - `"user-profiles-2026-03-24"`
109109
110 - `"user-profiles-2026-08-18"`
111
110112 - `"advisor-tool-2026-03-01"`
111113
112114 - `"managed-agents-2026-04-01"`
from line 2176
21742176
21752177 - `string`
21762178
2177 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
2179 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
21782180
21792181 - `"message-batches-2024-09-24"`
21802182
from line 2222
22202222
22212223 - `"user-profiles-2026-03-24"`
22222224
2225 - `"user-profiles-2026-08-18"`
2226
22232227 - `"advisor-tool-2026-03-01"`
22242228
22252229 - `"managed-agents-2026-04-01"`
from line 3137
31333137
31343138 - `string`
31353139
3136 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
3140 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
31373141
31383142 - `"message-batches-2024-09-24"`
31393143
from line 3183
31793183
31803184 - `"user-profiles-2026-03-24"`
31813185
3186 - `"user-profiles-2026-08-18"`
3187
31823188 - `"advisor-tool-2026-03-01"`
31833189
31843190 - `"managed-agents-2026-04-01"`
from line 8948
89428948
89438949 - `type: "credential_host_unreachable_error"`
89448950
8945 - `"credential_host_unreachable_error"`
8946
8947 - `vault_id: string`
8948
8949 ID of the vault containing the affected credential.
8950
8951 - `pr
8951 - `"credential_host_unreachable_err
api/beta/sessions/list Changed · +5 / -3 lines
from line 83
8383
8484 - `string`
8585
86 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
86 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
8787
8888 - `"message-batches-2024-09-24"`
8989
from line 129
129129
130130 - `"user-profiles-2026-03-24"`
131131
132 - `"user-profiles-2026-08-18"`
133
132134 - `"advisor-tool-2026-03-01"`
133135
134136 - `"managed-agents-2026-04-01"`
from line 844
842844 }
843845 ],
844846 "model": {
845 "id": "claude-sonnet-4-6",
847 "id": "claude-opus-5",
846848 "effort": {
847849 "type": "low"
848850 },
from line 864
862864 }
863865 ],
864866 "model": {
865 "id": "claude-sonnet-4-6",
867 "id": "claude-opus-5",
866868 "effort": {
867869 "type": "low"
868870 },
api/beta/sessions/resources Changed · +15 / -5 lines
from line 23
2323
2424 - `string`
2525
26 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
26 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2727
2828 - `"message-batches-2024-09-24"`
2929
from line 69
6969
7070 - `"user-profiles-2026-03-24"`
7171
72 - `"user-profiles-2026-08-18"`
73
7274 - `"advisor-tool-2026-03-01"`
7375
7476 - `"managed-agents-2026-04-01"`
from line 185
183185
184186 - `string`
185187
186 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
188 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
187189
188190 - `"message-batches-2024-09-24"`
189191
from line 231
229231
230232 - `"user-profiles-2026-03-24"`
231233
234 - `"user-profiles-2026-08-18"`
235
232236 - `"advisor-tool-2026-03-01"`
233237
234238 - `"managed-agents-2026-04-01"`
from line 422
418422
419423 - `string`
420424
421 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
425 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
422426
423427 - `"message-batches-2024-09-24"`
424428
from line 468
464468
465469 - `"user-profiles-2026-03-24"`
466470
471 - `"user-profiles-2026-08-18"`
472
467473 - `"advisor-tool-2026-03-01"`
468474
469475 - `"managed-agents-2026-04-01"`
from line 638
632638
633639 - `string`
634640
635 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
641 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
636642
637643 - `"message-batches-2024-09-24"`
638644
from line 684
678684
679685 - `"user-profiles-2026-03-24"`
680686
687 - `"user-profiles-2026-08-18"`
688
681689 - `"advisor-tool-2026-03-01"`
682690
683691 - `"managed-agents-2026-04-01"`
from line 864
856864
857865 - `string`
858866
859 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
867 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
860868
861869 - `"message-batches-2024-09-24"`
862870
from line 909
901909 - `"output-300k-2026-03-24"`
902910
903911 - `"user-profiles-2026-03-24"`
912
913 - `"user-profiles-2026-08-18"`
904914
905915 - `"advisor-tool-2026-03-01"`
906916
api/beta/sessions/retrieve Changed · +5 / -3 lines
from line 21
2121
2222 - `string`
2323
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2525
2626 - `"message-batches-2024-09-24"`
2727
from line 67
6767
6868 - `"user-profiles-2026-03-24"`
6969
70 - `"user-profiles-2026-08-18"`
71
7072 - `"advisor-tool-2026-03-01"`
7173
7274 - `"managed-agents-2026-04-01"`
from line 772
770772 }
771773 ],
772774 "model": {
773 "id": "claude-sonnet-4-6",
775 "id": "claude-opus-5",
774776 "effort": {
775777 "type": "low"
776778 },
from line 792
790792 }
791793 ],
792794 "model": {
793 "id": "claude-sonnet-4-6",
795 "id": "claude-opus-5",
794796 "effort": {
795797 "type": "low"
796798 },
api/beta/sessions/threads Changed · +18 / -8 lines
from line 33
3333
3434 - `string`
3535
36 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
36 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
3737
3838 - `"message-batches-2024-09-24"`
3939
from line 79
7979
8080 - `"user-profiles-2026-03-24"`
8181
82 - `"user-profiles-2026-08-18"`
83
8284 - `"advisor-tool-2026-03-01"`
8385
8486 - `"managed-agents-2026-04-01"`
from line 588
586588 }
587589 ],
588590 "model": {
589 "id": "claude-sonnet-4-6",
591 "id": "claude-opus-5",
590592 "effort": {
591593 "type": "low"
592594 },
from line 683
681683
682684 - `string`
683685
684 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
686 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
685687
686688 - `"message-batches-2024-09-24"`
687689
from line 729
727729
728730 - `"user-profiles-2026-03-24"`
729731
732 - `"user-profiles-2026-08-18"`
733
730734 - `"advisor-tool-2026-03-01"`
731735
732736 - `"managed-agents-2026-04-01"`
from line 1232
12281232 }
12291233 ],
12301234 "model": {
1231 "id": "claude-sonnet-4-6",
1235 "id": "claude-opus-5",
12321236 "effort": {
12331237 "type": "low"
12341238 },
from line 1324
13201324
13211325 - `string`
13221326
1323 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
1327 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
13241328
13251329 - `"message-batches-2024-09-24"`
13261330
from line 1370
13661370
13671371 - `"user-profiles-2026-03-24"`
13681372
1373 - `"user-profiles-2026-08-18"`
1374
13691375 - `"advisor-tool-2026-03-01"`
13701376
13711377 - `"managed-agents-2026-04-01"`
from line 1874
18681874 }
18691875 ],
18701876 "model": {
1871 "id": "claude-sonnet-4-6",
1877 "id": "claude-opus-5",
18721878 "effort": {
18731879 "type": "low"
18741880 },
from line 4568
45624568
45634569 - `string`
45644570
4565 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
4571 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
45664572
45674573 - `"message-batches-2024-09-24"`
45684574
from line 4614
46084614
46094615 - `"user-profiles-2026-03-24"`
46104616
4617 - `"user-profiles-2026-08-18"`
4618
46114619 - `"advisor-tool-2026-03-01"`
46124620
46134621 - `"managed-agents-2026-04-01"`
from line 6684
66766684
66776685 - `string`
66786686
6679 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
6687 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
66806688
66816689 - `"message-batches-2024-09-24"`
66826690
from line 6729
67216729 - `"output-300k-2026-03-24"`
67226730
67236731 - `"user-profiles-2026-03-24"`
6732
6733 - `"user-profiles-2026-08-18"`
67246734
67256735 - `"advisor-tool-2026-03-01"`
67266736
api/beta/sessions/threads/archive Changed · +4 / -2 lines
from line 23
2323
2424 - `string`
2525
26 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
26 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2727
2828 - `"message-batches-2024-09-24"`
2929
from line 69
6969
7070 - `"user-profiles-2026-03-24"`
7171
72 - `"user-profiles-2026-08-18"`
73
7274 - `"advisor-tool-2026-03-01"`
7375
7476 - `"managed-agents-2026-04-01"`
from line 573
571573 }
572574 ],
573575 "model": {
574 "id": "claude-sonnet-4-6",
576 "id": "claude-opus-5",
575577 "effort": {
576578 "type": "low"
577579 },
api/beta/sessions/threads/events Changed · +6 / -2 lines
from line 35
3535
3636 - `string`
3737
38 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
38 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
3939
4040 - `"message-batches-2024-09-24"`
4141
from line 81
8181
8282 - `"user-profiles-2026-03-24"`
8383
84 - `"user-profiles-2026-08-18"`
85
8486 - `"advisor-tool-2026-03-01"`
8587
8688 - `"managed-agents-2026-04-01"`
from line 2151
21492151
21502152 - `string`
21512153
2152 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
2154 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
21532155
21542156 - `"message-batches-2024-09-24"`
21552157
from line 2196
21942196 - `"output-300k-2026-03-24"`
21952197
21962198 - `"user-profiles-2026-03-24"`
2199
2200 - `"user-profiles-2026-08-18"`
21972201
21982202 - `"advisor-tool-2026-03-01"`
21992203
api/beta/sessions/threads/list Changed · +4 / -2 lines
from line 31
3131
3232 - `string`
3333
34 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
34 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
3535
3636 - `"message-batches-2024-09-24"`
3737
from line 77
7777
7878 - `"user-profiles-2026-03-24"`
7979
80 - `"user-profiles-2026-08-18"`
81
8082 - `"advisor-tool-2026-03-01"`
8183
8284 - `"managed-agents-2026-04-01"`
from line 586
584586 }
585587 ],
586588 "model": {
587 "id": "claude-sonnet-4-6",
589 "id": "claude-opus-5",
588590 "effort": {
589591 "type": "low"
590592 },
api/beta/sessions/threads/retrieve Changed · +4 / -2 lines
from line 23
2323
2424 - `string`
2525
26 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
26 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2727
2828 - `"message-batches-2024-09-24"`
2929
from line 69
6969
7070 - `"user-profiles-2026-03-24"`
7171
72 - `"user-profiles-2026-08-18"`
73
7274 - `"advisor-tool-2026-03-01"`
7375
7476 - `"managed-agents-2026-04-01"`
from line 572
570572 }
571573 ],
572574 "model": {
573 "id": "claude-sonnet-4-6",
575 "id": "claude-opus-5",
574576 "effort": {
575577 "type": "low"
576578 },
api/beta/sessions/update Changed · +5 / -3 lines
from line 21
2121
2222 - `string`
2323
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2525
2626 - `"message-batches-2024-09-24"`
2727
from line 67
6767
6868 - `"user-profiles-2026-03-24"`
6969
70 - `"user-profiles-2026-08-18"`
71
7072 - `"advisor-tool-2026-03-01"`
7173
7274 - `"managed-agents-2026-04-01"`
from line 996
994996 }
995997 ],
996998 "model": {
997 "id": "claude-sonnet-4-6",
999 "id": "claude-opus-5",
9981000 "effort": {
9991001 "type": "low"
10001002 },
from line 1016
10141016 }
10151017 ],
10161018 "model": {
1017 "id": "claude-sonnet-4-6",
1019 "id": "claude-opus-5",
10181020 "effort": {
10191021 "type": "low"
10201022 },
api/beta/skills Changed · +27 / -9 lines
from line 19
1919
2020 - `string`
2121
22 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
22 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2323
2424 - `"message-batches-2024-09-24"`
2525
from line 65
6565
6666 - `"user-profiles-2026-03-24"`
6767
68 - `"user-profiles-2026-08-18"`
69
6870 - `"advisor-tool-2026-03-01"`
6971
7072 - `"managed-agents-2026-04-01"`
from line 194
192194
193195 - `string`
194196
195 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
197 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
196198
197199 - `"message-batches-2024-09-24"`
198200
from line 240
238240
239241 - `"user-profiles-2026-03-24"`
240242
243 - `"user-profiles-2026-08-18"`
244
241245 - `"advisor-tool-2026-03-01"`
242246
243247 - `"managed-agents-2026-04-01"`
from line 374
370374
371375 - `string`
372376
373 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
377 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
374378
375379 - `"message-batches-2024-09-24"`
376380
from line 420
416420
417421 - `"user-profiles-2026-03-24"`
418422
423 - `"user-profiles-2026-08-18"`
424
419425 - `"advisor-tool-2026-03-01"`
420426
421427 - `"managed-agents-2026-04-01"`
from line 532
526532
527533 - `string`
528534
529 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
535 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
530536
531537 - `"message-batches-2024-09-24"`
532538
from line 578
572578
573579 - `"user-profiles-2026-03-24"`
574580
581 - `"user-profiles-2026-08-18"`
582
575583 - `"advisor-tool-2026-03-01"`
576584
577585 - `"managed-agents-2026-04-01"`
from line 812
804812
805813 - `string`
806814
807 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
815 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
808816
809817 - `"message-batches-2024-09-24"`
810818
from line 858
850858
851859 - `"user-profiles-2026-03-24"`
852860
861 - `"user-profiles-2026-08-18"`
862
853863 - `"advisor-tool-2026-03-01"`
854864
855865 - `"managed-agents-2026-04-01"`
from line 988
978988
979989 - `string`
980990
981 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
991 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
982992
983993 - `"message-batches-2024-09-24"`
984994
from line 1034
10241034
10251035 - `"user-profiles-2026-03-24"`
10261036
1037 - `"user-profiles-2026-08-18"`
1038
10271039 - `"advisor-tool-2026-03-01"`
10281040
10291041 - `"managed-agents-2026-04-01"`
from line 1174
11621174
11631175 - `string`
11641176
1165 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
1177 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
11661178
11671179 - `"message-batches-2024-09-24"`
11681180
from line 1220
12081220
12091221 - `"user-profiles-2026-03-24"`
12101222
1223 - `"user-profiles-2026-08-18"`
1224
12111225 - `"advisor-tool-2026-03-01"`
12121226
12131227 - `"managed-agents-2026-04-01"`
from line 1281
12671281
12681282 - `string`
12691283
1270 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
1284 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
12711285
12721286 - `"message-batches-2024-09-24"`
12731287
from line 1327
13131327
13141328 - `"user-profiles-2026-03-24"`
13151329
1330 - `"user-profiles-2026-08-18"`
1331
13161332 - `"advisor-tool-2026-03-01"`
13171333
13181334 - `"managed-agents-2026-04-01"`
from line 1449
14331449
14341450 - `string`
14351451
1436 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
1452 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
14371453
14381454 - `"message-batches-2024-09-24"`
14391455
from line 1494
14781494 - `"output-300k-2026-03-24"`
14791495
14801496 - `"user-profiles-2026-03-24"`
1497
1498 - `"user-profiles-2026-08-18"`
14811499
14821500 - `"advisor-tool-2026-03-01"`
14831501
api/beta/skills/versions Changed · +15 / -5 lines
from line 27
2727
2828 - `string`
2929
30 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
30 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
3131
3232 - `"message-batches-2024-09-24"`
3333
from line 73
7373
7474 - `"user-profiles-2026-03-24"`
7575
76 - `"user-profiles-2026-08-18"`
77
7678 - `"advisor-tool-2026-03-01"`
7779
7880 - `"managed-agents-2026-04-01"`
from line 203
201203
202204 - `string`
203205
204 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
206 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
205207
206208 - `"message-batches-2024-09-24"`
207209
from line 249
247249
248250 - `"user-profiles-2026-03-24"`
249251
252 - `"user-profiles-2026-08-18"`
253
250254 - `"advisor-tool-2026-03-01"`
251255
252256 - `"managed-agents-2026-04-01"`
from line 389
385389
386390 - `string`
387391
388 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
392 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
389393
390394 - `"message-batches-2024-09-24"`
391395
from line 435
431435
432436 - `"user-profiles-2026-03-24"`
433437
438 - `"user-profiles-2026-08-18"`
439
434440 - `"advisor-tool-2026-03-01"`
435441
436442 - `"managed-agents-2026-04-01"`
from line 496
490496
491497 - `string`
492498
493 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
499 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
494500
495501 - `"message-batches-2024-09-24"`
496502
from line 542
536542
537543 - `"user-profiles-2026-03-24"`
538544
545 - `"user-profiles-2026-08-18"`
546
539547 - `"advisor-tool-2026-03-01"`
540548
541549 - `"managed-agents-2026-04-01"`
from line 664
656664
657665 - `string`
658666
659 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
667 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
660668
661669 - `"message-batches-2024-09-24"`
662670
from line 709
701709 - `"output-300k-2026-03-24"`
702710
703711 - `"user-profiles-2026-03-24"`
712
713 - `"user-profiles-2026-08-18"`
704714
705715 - `"advisor-tool-2026-03-01"`
706716
api/beta/tunnels Changed · +30 / -10 lines
from line 21
2121
2222 - `string`
2323
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2525
2626 - `"message-batches-2024-09-24"`
2727
from line 67
6767
6868 - `"user-profiles-2026-03-24"`
6969
70 - `"user-profiles-2026-08-18"`
71
7072 - `"advisor-tool-2026-03-01"`
7173
7274 - `"managed-agents-2026-04-01"`
from line 171
169171
170172 - `string`
171173
172 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
174 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
173175
174176 - `"message-batches-2024-09-24"`
175177
from line 217
215217
216218 - `"user-profiles-2026-03-24"`
217219
220 - `"user-profiles-2026-08-18"`
221
218222 - `"advisor-tool-2026-03-01"`
219223
220224 - `"managed-agents-2026-04-01"`
from line 323
319323
320324 - `string`
321325
322 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
326 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
323327
324328 - `"message-batches-2024-09-24"`
325329
from line 369
365369
366370 - `"user-profiles-2026-03-24"`
367371
372 - `"user-profiles-2026-08-18"`
373
368374 - `"advisor-tool-2026-03-01"`
369375
370376 - `"managed-agents-2026-04-01"`
from line 474
468474
469475 - `string`
470476
471 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
477 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
472478
473479 - `"message-batches-2024-09-24"`
474480
from line 520
514520
515521 - `"user-profiles-2026-03-24"`
516522
523 - `"user-profiles-2026-08-18"`
524
517525 - `"advisor-tool-2026-03-01"`
518526
519527 - `"managed-agents-2026-04-01"`
from line 617
609617
610618 - `string`
611619
612 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
620 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
613621
614622 - `"message-batches-2024-09-24"`
615623
from line 663
655663
656664 - `"user-profiles-2026-03-24"`
657665
666 - `"user-profiles-2026-08-18"`
667
658668 - `"advisor-tool-2026-03-01"`
659669
660670 - `"managed-agents-2026-04-01"`
from line 745
735745
736746 - `string`
737747
738 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
748 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
739749
740750 - `"message-batches-2024-09-24"`
741751
from line 791
781791
782792 - `"user-profiles-2026-03-24"`
783793
794 - `"user-profiles-2026-08-18"`
795
784796 - `"advisor-tool-2026-03-01"`
785797
786798 - `"managed-agents-2026-04-01"`
from line 932
920932
921933 - `string`
922934
923 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
935 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
924936
925937 - `"message-batches-2024-09-24"`
926938
from line 978
966978
967979 - `"user-profiles-2026-03-24"`
968980
981 - `"user-profiles-2026-08-18"`
982
969983 - `"advisor-tool-2026-03-01"`
970984
971985 - `"managed-agents-2026-04-01"`
from line 1091
10771091
10781092 - `string`
10791093
1080 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
1094 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
10811095
10821096 - `"message-batches-2024-09-24"`
10831097
from line 1137
11231137
11241138 - `"user-profiles-2026-03-24"`
11251139
1140 - `"user-profiles-2026-08-18"`
1141
11261142 - `"advisor-tool-2026-03-01"`
11271143
11281144 - `"managed-agents-2026-04-01"`
from line 1252
12361252
12371253 - `string`
12381254
1239 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
1255 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
12401256
12411257 - `"message-batches-2024-09-24"`
12421258
from line 1298
12821298
12831299 - `"user-profiles-2026-03-24"`
12841300
1301 - `"user-profiles-2026-08-18"`
1302
12851303 - `"advisor-tool-2026-03-01"`
12861304
12871305 - `"managed-agents-2026-04-01"`
from line 1410
13921410
13931411 - `string`
13941412
1395 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
1413 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
13961414
13971415 - `"message-batches-2024-09-24"`
13981416
from line 1455
14371455 - `"output-300k-2026-03-24"`
14381456
14391457 - `"user-profiles-2026-03-24"`
1458
1459 - `"user-profiles-2026-08-18"`
14401460
14411461 - `"advisor-tool-2026-03-01"`
14421462
api/beta/tunnels/certificates Changed · +12 / -4 lines
from line 25
2525
2626 - `string`
2727
28 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
28 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2929
3030 - `"message-batches-2024-09-24"`
3131
from line 71
7171
7272 - `"user-profiles-2026-03-24"`
7373
74 - `"user-profiles-2026-08-18"`
75
7476 - `"advisor-tool-2026-03-01"`
7577
7678 - `"managed-agents-2026-04-01"`
from line 184
182184
183185 - `string`
184186
185 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
187 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
186188
187189 - `"message-batches-2024-09-24"`
188190
from line 230
228230
229231 - `"user-profiles-2026-03-24"`
230232
233 - `"user-profiles-2026-08-18"`
234
231235 - `"advisor-tool-2026-03-01"`
232236
233237 - `"managed-agents-2026-04-01"`
from line 345
341345
342346 - `string`
343347
344 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
348 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
345349
346350 - `"message-batches-2024-09-24"`
347351
from line 391
387391
388392 - `"user-profiles-2026-03-24"`
389393
394 - `"user-profiles-2026-08-18"`
395
390396 - `"advisor-tool-2026-03-01"`
391397
392398 - `"managed-agents-2026-04-01"`
from line 503
497503
498504 - `string`
499505
500 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
506 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
501507
502508 - `"message-batches-2024-09-24"`
503509
from line 548
542548 - `"output-300k-2026-03-24"`
543549
544550 - `"user-profiles-2026-03-24"`
551
552 - `"user-profiles-2026-08-18"`
545553
546554 - `"advisor-tool-2026-03-01"`
547555
api/beta/user_profiles Changed · +258 / -188 lines
from line 19
1919
2020 - `string`
2121
22 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
22 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2323
2424 - `"message-batches-2024-09-24"`
2525
from line 65
6565
6666 - `"user-profiles-2026-03-24"`
6767
68 - `"user-profiles-2026-08-18"`
69
6870 - `"advisor-tool-2026-03-01"`
6971
7072 - `"managed-agents-2026-04-01"`
from line 91
8991
9092### Body Parameters
9193
94- `access_type: optional "application" or "passthrough"`
95
96 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
97
98 - `"application"`
99
100 - `"passthrough"`
101
92102- `external_id: optional string or null`
93103
94104 Platform's own identifier for this user. Not enforced unique. Maximum 255 characters.
from line 109
99109
100110- `name: optional string or null`
101111
102 Display name of the entity this profile represents. Required when relationship is `resold` (the resold-to company's name); optional otherwise. Maximum 255 characters.
112 Optional for all profiles. Real-world name of the entity this profile represents (company or individual); for a resold-to company (`relationship` `resold` / `access_type` `passthrough`), that company's name where known. Maximum 255 characters.
103113
104114- `relationship: optional "external" or "resold" or "internal"`
105115
from line 123
113123
114124### Returns
115125
116- `BetaUserProfile object { id, created_at, metadata, 6 more }`
126- `BetaUserProfile object { id, created_at, metadata, 7 more }`
117127
118128 - `id: string`
119129
from line 137
127137
128138 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
129139
130 - `relationship: "external" or "resold" or "internal"`
131
132 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
133
134 - `"external"`
135
136 - `"resold"`
137
138 - `"internal"`
139
140140 - `trust_grants: map[BetaUserProfileTrustGrant]`
141141
142142 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 161
161161
162162 A timestamp in RFC 3339 format
163163
164 - `access_type: optional "application" or "passthrough"`
165
166 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
167
168 - `"application"`
169
170 - `"passthrough"`
171
164172 - `external_id: optional string or null`
165173
166174 Platform's own identifier for this user. Not enforced unique.
from line 175
167175
168176 - `name: optional string or null`
169177
170 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
178 Real-world name of the entity this profile represents (company or individual). For a resold-to company (`access_type` `passthrough`, or `relationship` `resold` under the `user-profiles-2026-03-24` header) this is that company's name.
171179
180 - `relationship: optional "external" or "resold" or "internal"`
181
182 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
183
184 - `"external"`
185
186 - `"resold"`
187
188 - `"internal"`
189
172190### Example
173191
174192```http
from line 193
175193curl https://api.anthropic.com/v1/user_profiles \
176194 -H 'Content-Type: application/json' \
177195 -H 'anthropic-version: 2023-06-01' \
178 -H 'anthropic-beta: user-profiles-2026-03-24' \
196 -H 'anthropic-beta: user-profiles-2026-08-18' \
179197 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
180198 -d '{
181199 "external_id": "user_12345",
from line 208
190208 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
191209 "created_at": "2026-03-15T10:00:00Z",
192210 "metadata": {},
193 "relationship": "external",
194211 "trust_grants": {
195212 "cyber": {
196213 "status": "active"
from line 215
198215 },
199216 "type": "user_profile",
200217 "updated_at": "2026-03-15T10:00:00Z",
218 "access_type": "application",
201219 "external_id": "user_12345",
202 "name": "Example User"
220 "name": "Example User",
221 "relationship": "external"
203222}
204223```
205224
from line 254
235254
236255 - `string`
237256
238 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
257 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
239258
240259 - `"message-batches-2024-09-24"`
241260
from line 300
281300
282301 - `"user-profiles-2026-03-24"`
283302
303 - `"user-profiles-2026-08-18"`
304
284305 - `"advisor-tool-2026-03-01"`
285306
286307 - `"managed-agents-2026-04-01"`
from line 342
321342
322343 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
323344
324 - `relationship: "external" or "resold" or "internal"`
325
326 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
327
328 - `"external"`
329
330 - `"resold"`
331
332 - `"internal"`
333
334345 - `trust_grants: map[BetaUserProfileTrustGrant]`
335346
336347 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 366
355366
356367 A timestamp in RFC 3339 format
357368
369 - `access_type: optional "application" or "passthrough"`
370
371 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
372
373 - `"application"`
374
375 - `"passthrough"`
376
358377 - `external_id: optional string or null`
359378
360379 Platform's own identifier for this user. Not enforced unique.
from line 380
361380
362381 - `name: optional string or null`
363382
364 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
383 Real-world name of the entity this profile represents (company or individual). For a resold-to company (`access_type` `passthrough`, or `relationship` `resold` under the `user-profiles-2026-03-24` header) this is that company's name.
365384
385 - `relationship: optional "external" or "resold" or "internal"`
386
387 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
388
389 - `"external"`
390
391 - `"resold"`
392
393 - `"internal"`
394
366395- `next_page: string or null`
367396
368397 Cursor for the next page, or `null` when there are no more results.
from line 401
372401```http
373402curl https://api.anthropic.com/v1/user_profiles \
374403 -H 'anthropic-version: 2023-06-01' \
375 -H 'anthropic-beta: user-profiles-2026-03-24' \
404 -H 'anthropic-beta: user-profiles-2026-08-18' \
376405 -H "X-Api-Key: $ANTHROPIC_API_KEY"
377406```
378407
from line 414
385414 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
386415 "created_at": "2026-03-15T10:00:00Z",
387416 "metadata": {},
388 "relationship": "external",
389417 "trust_grants": {
390418 "cyber": {
391419 "status": "active"
from line 421
393421 },
394422 "type": "user_profile",
395423 "updated_at": "2026-03-15T10:00:00Z",
424 "access_type": "application",
396425 "external_id": "user_12345",
397 "name": "Example User"
426 "name": "Example User",
427 "relationship": "external"
398428 }
399429 ],
400430 "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
from line 449
419449
420450 - `string`
421451
422 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
452 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
423453
424454 - `"message-batches-2024-09-24"`
425455
from line 495
465495
466496 - `"user-profiles-2026-03-24"`
467497
498 - `"user-profiles-2026-08-18"`
499
468500 - `"advisor-tool-2026-03-01"`
469501
470502 - `"managed-agents-2026-04-01"`
from line 521
489521
490522### Returns
491523
492- `BetaUserProfile object { id, created_at, metadata, 6 more }`
524- `BetaUserProfile object { id, created_at, metadata, 7 more }`
493525
494526 - `id: string`
495527
from line 535
503535
504536 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
505537
506 - `relationship: "external" or "resold" or "internal"`
507
508 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
509
510 - `"external"`
511
512 - `"resold"`
513
514 - `"internal"`
515
516538 - `trust_grants: map[BetaUserProfileTrustGrant]`
517539
518540 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 559
537559
538560 A timestamp in RFC 3339 format
539561
562 - `access_type: optional "application" or "passthrough"`
563
564 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
565
566 - `"application"`
567
568 - `"passthrough"`
569
540570 - `external_id: optional string or null`
541571
542572 Platform's own identifier for this user. Not enforced unique.
from line 573
543573
544574 - `name: optional string or null`
545575
546 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
576 Real-world name of the entity this profile represents (company or individual). For a resold-to company (`access_type` `passthrough`, or `relationship` `resold` under the `user-profiles-2026-03-24` header) this is that company's name.
547577
578 - `relationship: optional "external" or "resold" or "internal"`
579
580 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
581
582 - `"external"`
583
584 - `"resold"`
585
586 - `"internal"`
587
548588### Example
549589
550590```http
551591curl https://api.anthropic.com/v1/user_profiles/$USER_PROFILE_ID \
552592 -H 'anthropic-version: 2023-06-01' \
553 -H 'anthropic-beta: user-profiles-2026-03-24' \
593 -H 'anthropic-beta: user-profiles-2026-08-18' \
554594 -H "X-Api-Key: $ANTHROPIC_API_KEY"
555595```
556596
from line 601
561601 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
562602 "created_at": "2026-03-15T10:00:00Z",
563603 "metadata": {},
564 "relationship": "external",
565604 "trust_grants": {
566605 "cyber": {
567606 "status": "active"
from line 608
569608 },
570609 "type": "user_profile",
571610 "updated_at": "2026-03-15T10:00:00Z",
611 "access_type": "application",
572612 "external_id": "user_12345",
573 "name": "Example User"
613 "name": "Example User",
614 "relationship": "external"
574615}
575616```
576617
from line 633
592633
593634 - `string`
594635
595 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
636 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
596637
597638 - `"message-batches-2024-09-24"`
598639
from line 679
638679
639680 - `"user-profiles-2026-03-24"`
640681
682 - `"user-profiles-2026-08-18"`
683
641684 - `"advisor-tool-2026-03-01"`
642685
643686 - `"managed-agents-2026-04-01"`
from line 705
662705
663706### Body Parameters
664707
708- `access_type: optional "application" or "passthrough" or null`
709
710 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
711
712 - `"application"`
713
714 - `"passthrough"`
715
665716- `external_id: optional string or null`
666717
667718 If present, replaces the stored external_id. Omit to leave unchanged. Maximum 255 characters.
from line 737
686737
687738### Returns
688739
689- `BetaUserProfile object { id, created_at, metadata, 6 more }`
740- `BetaUserProfile object { id, created_at, metadata, 7 more }`
690741
691742 - `id: string`
692743
from line 751
700751
701752 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
702753
703 - `relationship: "external" or "resold" or "internal"`
704
705 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
706
707 - `"external"`
708
709 - `"resold"`
710
711 - `"internal"`
712
713754 - `trust_grants: map[BetaUserProfileTrustGrant]`
714755
715756 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 775
734775
735776 A timestamp in RFC 3339 format
736777
778 - `access_type: optional "application" or "passthrough"`
779
780 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
781
782 - `"application"`
783
784 - `"passthrough"`
785
737786 - `external_id: optional string or null`
738787
739788 Platform's own identifier for this user. Not enforced unique.
from line 789
740789
741790 - `name: optional string or null`
742791
743 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
792 Real-world name of the entity this profile represents (company or individual). For a resold-to company (`access_type` `passthrough`, or `relationship` `resold` under the `user-profiles-2026-03-24` header) this is that company's name.
744793
794 - `relationship: optional "external" or "resold" or "internal"`
795
796 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
797
798 - `"external"`
799
800 - `"resold"`
801
802 - `"internal"`
803
745804### Example
746805
747806```http
from line 807
748807curl https://api.anthropic.com/v1/user_profiles/$USER_PROFILE_ID \
749808 -H 'Content-Type: application/json' \
750809 -H 'anthropic-version: 2023-06-01' \
751 -H 'anthropic-beta: user-profiles-2026-03-24' \
810 -H 'anthropic-beta: user-profiles-2026-08-18' \
752811 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
753812 -d '{
754813 "external_id": "user_12345"
from line 821
762821 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
763822 "created_at": "2026-03-15T10:00:00Z",
764823 "metadata": {},
765 "relationship": "external",
766824 "trust_grants": {
767825 "cyber": {
768826 "status": "active"
from line 828
770828 },
771829 "type": "user_profile",
772830 "updated_at": "2026-03-15T10:00:00Z",
831 "access_type": "application",
773832 "external_id": "user_12345",
774 "name": "Example User"
833 "name": "Example User",
834 "relationship": "external"
775835}
776836```
777837
from line 853
793853
794854 - `string`
795855
796 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
856 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
797857
798858 - `"message-batches-2024-09-24"`
799859
from line 899
839899
840900 - `"user-profiles-2026-03-24"`
841901
902 - `"user-profiles-2026-08-18"`
903
842904 - `"advisor-tool-2026-03-01"`
843905
844906 - `"managed-agents-2026-04-01"`
from line 947
885947curl https://api.anthropic.com/v1/user_profiles/$USER_PROFILE_ID/enrollment_url \
886948 -X POST \
887949 -H 'anthropic-version: 2023-06-01' \
888 -H 'anthropic-beta: user-profiles-2026-03-24' \
950 -H 'anthropic-beta: user-profiles-2026-08-18' \
889951 -H "X-Api-Key: $ANTHROPIC_API_KEY"
890952```
891953
from line 965
903965
904966### Beta User Profile
905967
906- `BetaUserProfile object { id, created_at, metadata, 6 more }`
968- `BetaUserProfile object { id, created_at, metadata, 7 more }`
907969
908970 - `id: string`
909971
from line 979
917979
918980 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
919981
920 - `relationship: "external" or "resold" or "internal"`
921
922 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
923
924 - `"external"`
925
926 - `"resold"`
927
928 - `"internal"`
929
930982 - `trust_grants: map[BetaUserProfileTrustGrant]`
931983
932984 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 1003
9511003
9521004 A timestamp in RFC 3339 format
9531005
1006 - `access_type: optional "application" or "passthrough"`
1007
1008 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
1009
1010 - `"application"`
1011
1012 - `"passthrough"`
1013
9541014 - `external_id: optional string or null`
9551015
9561016 Platform's own identifier for this user. Not enforced unique.
from line 1017
9571017
9581018 - `name: optional string or null`
9591019
960 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
1020 Real-world name of the entity this profile represents (company or individual). For a resold-to company (`access_type` `passthrough`, or `relationship` `resold` under the `user-profiles-2026-03-24` header) this is that company's name.
1021
1022 - `relationship: optional "external" or "resold" or "internal"`
1023
1024 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
1025
1026 - `"external"`
1027
1028 - `"resold"`
1029
1030 - `"internal"`
9611031
9621032### Beta User Profile Enrollment URL
9631033
api/beta/user_profiles/create Changed · +58 / -39 lines
from line 17
1717
1818 - `string`
1919
20 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
20 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2121
2222 - `"message-batches-2024-09-24"`
2323
from line 63
6363
6464 - `"user-profiles-2026-03-24"`
6565
66 - `"user-profiles-2026-08-18"`
67
6668 - `"advisor-tool-2026-03-01"`
6769
6870 - `"managed-agents-2026-04-01"`
from line 89
8789
8890### Body Parameters
8991
92- `access_type: optional "application" or "passthrough"`
93
94 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
95
96 - `"application"`
97
98 - `"passthrough"`
99
90100- `external_id: optional string or null`
91101
92102 Platform's own identifier for this user. Not enforced unique. Maximum 255 characters.
from line 107
97107
98108- `name: optional string or null`
99109
100 Display name of the entity this profile represents. Required when relationship is `resold` (the resold-to company's name); optional otherwise. Maximum 255 characters.
110 Optional for all profiles. Real-world name of the entity this profile represents (company or individual); for a resold-to company (`relationship` `resold` / `access_type` `passthrough`), that company's name where known. Maximum 255 characters.
101111
102112- `relationship: optional "external" or "resold" or "internal"`
103113
from line 121
111121
112122### Returns
113123
114- `BetaUserProfile object { id, created_at, metadata, 6 more }`
124- `BetaUserProfile object { id, created_at, metadata, 7 more }`
115125
116126 - `id: string`
117127
from line 135
125135
126136 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
127137
128 - `relationship: "external" or "resold" or "internal"`
129
130 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
131
132 - `"external"`
133
134 - `"resold"`
135
136 - `"internal"`
137
138138 - `trust_grants: map[BetaUserProfileTrustGrant]`
139139
140140 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 159
159159
160160 A timestamp in RFC 3339 format
161161
162 - `access_type: optional "application" or "passthrough"`
163
164 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
165
166 - `"application"`
167
168 - `"passthrough"`
169
162170 - `external_id: optional string or null`
163171
164172 Platform's own identifier for this user. Not enforced unique.
from line 173
165173
166174 - `name: optional string or null`
167175
168 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
176 Real-world name of the entity this profile represents (company or individual). For a resold-to company (`access_type` `passthrough`, or `relationship` `resold` under the `user-profiles-2026-03-24` header) this is that company's name.
169177
178 - `relationship: optional "external" or "resold" or "internal"`
179
180 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
181
182 - `"external"`
183
184 - `"resold"`
185
186 - `"internal"`
187
170188### Example
171189
172190```http
from line 191
173191curl https://api.anthropic.com/v1/user_profiles \
174192 -H 'Content-Type: application/json' \
175193 -H 'anthropic-version: 2023-06-01' \
176 -H 'anthropic-beta: user-profiles-2026-03-24' \
194 -H 'anthropic-beta: user-profiles-2026-08-18' \
177195 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
178196 -d '{
179197 "external_id": "user_12345",
from line 206
188206 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
189207 "created_at": "2026-03-15T10:00:00Z",
190208 "metadata": {},
191 "relationship": "external",
192209 "trust_grants": {
193210 "cyber": {
194211 "status": "active"
from line 213
196213 },
197214 "type": "user_profile",
198215 "updated_at": "2026-03-15T10:00:00Z",
216 "access_type": "application",
199217 "external_id": "user_12345",
200 "name": "Example User"
218 "name": "Example User",
219 "relationship": "external"
201220}
202221```
203222
api/beta/user_profiles/create_enrollment_url Changed · +4 / -2 lines
from line 21
2121
2222 - `string`
2323
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2525
2626 - `"message-batches-2024-09-24"`
2727
from line 67
6767
6868 - `"user-profiles-2026-03-24"`
6969
70 - `"user-profiles-2026-08-18"`
71
7072 - `"advisor-tool-2026-03-01"`
7173
7274 - `"managed-agents-2026-04-01"`
from line 115
113115curl https://api.anthropic.com/v1/user_profiles/$USER_PROFILE_ID/enrollment_url \
114116 -X POST \
115117 -H 'anthropic-version: 2023-06-01' \
116 -H 'anthropic-beta: user-profiles-2026-03-24' \
118 -H 'anthropic-beta: user-profiles-2026-08-18' \
117119 -H "X-Api-Key: $ANTHROPIC_API_KEY"
118120```
119121