Follow Discord
Sweep 25 Sep 2026 · 19:33Z Build v2.1.283 504 read Stable v2.1.274 Latest v2.1.283 Next v2.1.283 Feeds RSS JSON llms.txt llms-full.txt Unofficial
One change · api

Retrieve Message Batch results changedapi/beta/messages/batches/results

Nearest release: v2.1.281, published an hour before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

Recorded here
Lines+2,168added
Lines−77removed
From line 27 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits15to this page, all time

The whole hunk

from line 27, old and new numbered
/
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 27
2727 
2828 - `string`
2929 
30 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`
30 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more`
3131 
3232 - `"message-batches-2024-09-24"`
3333 
from line 120
120120 - `"mid-conversation-system-clear-at-2026-08-21"`
121121 
122122 - `"compact-2026-09-04"`
123 
124 - `"inline-tools-2026-09-15"`
125 
126 - `"mcp-client-2026-09-15"`
123127 
124128- `"anthropic-workspace-id": optional string`
125129 
from line 1058
10541058 
10551059 Signature over the summary, to be sent back with the block verbatim
10561060 
1061 - `tool_changes: optional array of BetaResponseToolAdditionBlock or BetaResponseToolRemovalBlock or null`
1062 
1063 The tool changes of the compacted range: the `tool_addition` and `tool_removal` blocks that take the request's `tools` to the tool set in effect at the end of the range, or `[]` when the range changed no tool. Absent when the server did not compute them. Send the block back unchanged.
1064 
1065 - `BetaResponseToolAdditionBlock object`
1066 
1067 An entry of a `compaction` block's `tool_changes`: a tool the
1068 compacted range made available, as a reference to a `tools` entry or
1069 MCP toolset, or as the tool definition in effect at the end of the
1070 range, by value. Send it back unchanged.
1071 
1072 - `type: "tool_addition"`
1073 
1074 default: tool_addition
1075 
1076 - `tool: BetaResponseToolChangeToolReference or BetaResponseToolChangeMCPToolReference or BetaResponseToolChangeMCPToolsetReference or BetaToolChangeToolDefinition`
1077 
1078 The tool made available: a reference to a `tools` entry or MCP toolset, or a `tool_definition` carrying the definition by value.
1079 
1080 - `BetaResponseToolChangeToolReference object`
1081 
1082 Reference to a single tool, by the name the model uses to call it, as
1083 a `compaction` block's `tool_changes` entry reports it: a tool
1084 declared in `tools` or defined by an earlier `tool_addition` block.
1085 Send it back unchanged with the block.
1086 
1087 - `type: "tool_reference"`
1088 
1089 default: tool_reference
1090 
1091 - `name: string`
1092 
1093 - `BetaResponseToolChangeMCPToolReference object`
1094 
1095 Reference to a single MCP tool, by its server and its name on that
1096 server, as a `compaction` block's `tool_changes` entry reports it.
1097 Send it back unchanged with the block.
1098 
1099 - `type: "mcp_tool_reference"`
1100 
1101 default: mcp_tool_reference
1102 
1103 - `name: string`
1104 
1105 - `server_name: string`
1106 
1107 - `BetaResponseToolChangeMCPToolsetReference object`
1108 
1109 Reference to every tool in the named MCP server's toolset, as a
1110 `compaction` block's `tool_changes` entry reports it. Send it back
1111 unchanged with the block.
1112 
1113 - `type: "mcp_toolset_reference"`
1114 
1115 default: mcp_toolset_reference
1116 
1117 - `server_name: string`
1118 
1119 - `BetaToolChangeToolDefinition object`
1120 
1121 A tool defined by value, as a `compaction` block's `tool_changes` entry
1122 reports it: `definition` is the tool's definition as it was sent, in the
1123 form of a `tools` entry, without `cache_control`. Send it back unchanged
1124 with the block.
1125 
1126 - `type: "tool_definition"`
1127 
1128 default: tool_definition
1129 
1130 - `definition: BetaResponseToolUnion`
1131 
1132 - `BetaResponseTool object`
1133 
1134 A custom tool definition, as sent.
1135 
1136 - `type: optional "custom" or null`
1137 
1138 - `input_schema: BetaResponseToolInputSchema`
1139 
1140 [JSON schema](https://json-schema.org/draft/2020-12) for this tool's input.
1141 
1142 This defines the shape of the `input` that your tool accepts and that the model will produce.
1143 
1144 - `type: "object"`
1145 
1146 - `properties: optional map[unknown] or null`
1147 
1148 - `required: optional array of string or null`
1149 
1150 - `name: string`
1151 
1152 Name of the tool.
1153 
1154 This is how the tool will be called by the model and in `tool_use` blocks.
1155 
1156 maxLength: 128, minLength: 1, pattern: ^[a-zA-Z0-9_-]{1,128}$
1157 
1158 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1159 
1160 - `"direct"`
1161 
1162 - `"code_execution_20250825"`
1163 
1164 - `"code_execution_20260120"`
1165 
1166 - `"code_execution_20260521"`
1167 
1168 - `defer_loading: optional boolean`
1169 
1170 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
1171 
1172 - `description: optional string`
1173 
1174 Description of what this tool does.
1175 
1176 Tool descriptions should be as detailed as possible. The more information that the model has about what the tool is and how to use it, the better it will perform. You can use natural language descriptions to reinforce important aspects of the tool input JSON schema.
1177 
1178 - `eager_input_streaming: optional boolean or null`
1179 
1180 Enable eager input streaming for this tool. When true, tool input parameters will be streamed incrementally as they are generated, and types will be inferred on-the-fly rather than buffering the full JSON output. When false, streaming is disabled for this tool even if the fine-grained-tool-streaming beta is active. When null (default), uses the default behavior based on beta headers.
1181 
1182 - `input_examples: optional array of map[unknown]`
1183 
1184 - `strict: optional boolean`
1185 
1186 When true, guarantees schema validation on tool names and inputs
1187 
1188 - `BetaToolBash20241022 object`
1189 
1190 - `type: "bash_20241022"`
1191 
1192 - `name: "bash"`
1193 
1194 Name of the tool.
1195 
1196 This is how the tool will be called by the model and in `tool_use` blocks.
1197 
1198 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1199 
1200 - `"direct"`
1201 
1202 - `"code_execution_20250825"`
1203 
1204 - `"code_execution_20260120"`
1205 
1206 - `"code_execution_20260521"`
1207 
1208 - `cache_control: optional BetaCacheControlEphemeral or null`
1209 
1210 Create a cache control breakpoint at this content block.
1211 
1212 - `type: "ephemeral"`
1213 
1214 - `ttl: optional "5m" or "1h"`
1215 
1216 The time-to-live for the cache control breakpoint.
1217 
1218 This may be one the following values:
1219 
1220 - `5m`: 5 minutes
1221 - `1h`: 1 hour
1222 
1223 Defaults to `5m`. See [prompt caching pricing](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) for details.
1224 
1225 - `"5m"`
1226 
1227 - `"1h"`
1228 
1229 - `defer_loading: optional boolean`
1230 
1231 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
1232 
1233 - `input_examples: optional array of map[unknown]`
1234 
1235 - `strict: optional boolean`
1236 
1237 When true, guarantees schema validation on tool names and inputs
1238 
1239 - `BetaToolBash20250124 object`
1240 
1241 - `type: "bash_20250124"`
1242 
1243 - `name: "bash"`
1244 
1245 Name of the tool.
1246 
1247 This is how the tool will be called by the model and in `tool_use` blocks.
1248 
1249 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1250 
1251 - `"direct"`
1252 
1253 - `"code_execution_20250825"`
1254 
1255 - `"code_execution_20260120"`
1256 
1257 - `"code_execution_20260521"`
1258 
1259 - `cache_control: optional BetaCacheControlEphemeral or null`
1260 
1261 Create a cache control breakpoint at this content block.
1262 
1263 - `defer_loading: optional boolean`
1264 
1265 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
1266 
1267 - `input_examples: optional array of map[unknown]`
1268 
1269 - `strict: optional boolean`
1270 
1271 When true, guarantees schema validation on tool names and inputs
1272 
1273 - `BetaCodeExecutionTool20250522 object`
1274 
1275 - `type: "code_execution_20250522"`
1276 
1277 - `name: "code_execution"`
1278 
1279 Name of the tool.
1280 
1281 This is how the tool will be called by the model and in `tool_use` blocks.
1282 
1283 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1284 
1285 - `"direct"`
1286 
1287 - `"code_execution_20250825"`
1288 
1289 - `"code_execution_20260120"`
1290 
1291 - `"code_execution_20260521"`
1292 
1293 - `cache_control: optional BetaCacheControlEphemeral or null`
1294 
1295 Create a cache control breakpoint at this content block.
1296 
1297 - `defer_loading: optional boolean`
1298 
1299 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
1300 
1301 - `strict: optional boolean`
1302 
1303 When true, guarantees schema validation on tool names and inputs
1304 
1305 - `BetaCodeExecutionTool20250825 object`
1306 
1307 - `type: "code_execution_20250825"`
1308 
1309 - `name: "code_execution"`
1310 
1311 Name of the tool.
1312 
1313 This is how the tool will be called by the model and in `tool_use` blocks.
1314 
1315 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1316 
1317 - `"direct"`
1318 
1319 - `"code_execution_20250825"`
1320 
1321 - `"code_execution_20260120"`
1322 
1323 - `"code_execution_20260521"`
1324 
1325 - `cache_control: optional BetaCacheControlEphemeral or null`
1326 
1327 Create a cache control breakpoint at this content block.
1328 
1329 - `defer_loading: optional boolean`
1330 
1331 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
1332 
1333 - `strict: optional boolean`
1334 
1335 When true, guarantees schema validation on tool names and inputs
1336 
1337 - `BetaCodeExecutionTool20260120 object`
1338 
1339 Code execution tool with REPL state persistence (daemon mode + gVisor checkpoint).
1340 
1341 - `type: "code_execution_20260120"`
1342 
1343 - `name: "code_execution"`
1344 
1345 Name of the tool.
1346 
1347 This is how the tool will be called by the model and in `tool_use` blocks.
1348 
1349 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1350 
1351 - `"direct"`
1352 
1353 - `"code_execution_20250825"`
1354 
1355 - `"code_execution_20260120"`
1356 
1357 - `"code_execution_20260521"`
1358 
1359 - `cache_control: optional BetaCacheControlEphemeral or null`
1360 
1361 Create a cache control breakpoint at this content block.
1362 
1363 - `defer_loading: optional boolean`
1364 
1365 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
1366 
1367 - `strict: optional boolean`
1368 
1369 When true, guarantees schema validation on tool names and inputs
1370 
1371 - `BetaCodeExecutionTool20260521 object`
1372 
1373 Code execution tool with REPL state persistence.
1374 
1375 - `type: "code_execution_20260521"`
1376 
1377 - `name: "code_execution"`
1378 
1379 Name of the tool.
1380 
1381 This is how the tool will be called by the model and in `tool_use` blocks.
1382 
1383 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1384 
1385 - `"direct"`
1386 
1387 - `"code_execution_20250825"`
1388 
1389 - `"code_execution_20260120"`
1390 
1391 - `"code_execution_20260521"`
1392 
1393 - `cache_control: optional BetaCacheControlEphemeral or null`
1394 
1395 Create a cache control breakpoint at this content block.
1396 
1397 - `defer_loading: optional boolean`
1398 
1399 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
1400 
1401 - `strict: optional boolean`
1402 
1403 When true, guarantees schema validation on tool names and inputs
1404 
1405 - `BetaBrowserToolset20260801 object`
1406 
1407 The browser toolset: a single `tools[]` entry (carrying no
1408 `name`) that declares the browser tool family. The model is served
1409 the family's tool with any members disabled via `configs` removed
1410 from its schema.
1411 
1412 - `type: "browser_toolset_20260801"`
1413 
1414 - `cache_control: optional BetaCacheControlEphemeral or null`
1415 
1416 Create a cache control breakpoint at this content block.
1417 
1418 - `configs: optional BetaBrowserToolsetConfigs or null`
1419 
1420 Per-member configuration for `browser_toolset_20260801`: one
1421 optional field per member tool, keyed by the member name — the same
1422 name the member's `tool_use` blocks carry. Every member is an
1423 accepted key, and a member's defaults apply wherever its key is
1424 absent. Unknown keys are rejected: the field set is this toolset
1425 version's complete member set.
1426 
1427 - `type: optional BetaBrowserTypeConfig or null`
1428 
1429 `type`'s config overrides.
1430 
1431 - `defer_loading: optional boolean or null`
1432 
1433 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1434 
1435 - `enabled: optional boolean or null`
1436 
1437 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.
1438 
1439 - `close_tab: optional BetaBrowserCloseTabConfig or null`
1440 
1441 `close_tab`'s config overrides.
1442 
1443 - `defer_loading: optional boolean or null`
1444 
1445 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1446 
1447 - `enabled: optional boolean or null`
1448 
1449 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.
1450 
1451 - `double_click: optional BetaBrowserDoubleClickConfig or null`
1452 
1453 `double_click`'s config overrides.
1454 
1455 - `defer_loading: optional boolean or null`
1456 
1457 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1458 
1459 - `enabled: optional boolean or null`
1460 
1461 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.
1462 
1463 - `file_upload: optional BetaBrowserFileUploadConfig or null`
1464 
1465 `file_upload`'s config overrides.
1466 
1467 - `defer_loading: optional boolean or null`
1468 
1469 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1470 
1471 - `enabled: optional boolean or null`
1472 
1473 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.
1474 
1475 - `find: optional BetaBrowserFindConfig or null`
1476 
1477 `find`'s config overrides.
1478 
1479 - `defer_loading: optional boolean or null`
1480 
1481 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1482 
1483 - `enabled: optional boolean or null`
1484 
1485 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.
1486 
1487 - `form_input: optional BetaBrowserFormInputConfig or null`
1488 
1489 `form_input`'s config overrides.
1490 
1491 - `defer_loading: optional boolean or null`
1492 
1493 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1494 
1495 - `enabled: optional boolean or null`
1496 
1497 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.
1498 
1499 - `get_page_text: optional BetaBrowserGetPageTextConfig or null`
1500 
1501 `get_page_text`'s config overrides.
1502 
1503 - `defer_loading: optional boolean or null`
1504 
1505 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1506 
1507 - `enabled: optional boolean or null`
1508 
1509 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.
1510 
1511 - `hold_key: optional BetaBrowserHoldKeyConfig or null`
1512 
1513 `hold_key`'s config overrides.
1514 
1515 - `defer_loading: optional boolean or null`
1516 
1517 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1518 
1519 - `enabled: optional boolean or null`
1520 
1521 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.
1522 
1523 - `hover: optional BetaBrowserHoverConfig or null`
1524 
1525 `hover`'s config overrides.
1526 
1527 - `defer_loading: optional boolean or null`
1528 
1529 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1530 
1531 - `enabled: optional boolean or null`
1532 
1533 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.
1534 
1535 - `javascript_exec: optional BetaBrowserJavascriptExecConfig or null`
1536 
1537 `javascript_exec`'s config overrides.
1538 
1539 - `defer_loading: optional boolean or null`
1540 
1541 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1542 
1543 - `enabled: optional boolean or null`
1544 
1545 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.
1546 
1547 - `key: optional BetaBrowserKeyConfig or null`
1548 
1549 `key`'s config overrides.
1550 
1551 - `defer_loading: optional boolean or null`
1552 
1553 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1554 
1555 - `enabled: optional boolean or null`
1556 
1557 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.
1558 
1559 - `left_click: optional BetaBrowserLeftClickConfig or null`
1560 
1561 `left_click`'s config overrides.
1562 
1563 - `defer_loading: optional boolean or null`
1564 
1565 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1566 
1567 - `enabled: optional boolean or null`
1568 
1569 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.
1570 
1571 - `left_click_drag: optional BetaBrowserLeftClickDragConfig or null`
1572 
1573 `left_click_drag`'s config overrides.
1574 
1575 - `defer_loading: optional boolean or null`
1576 
1577 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1578 
1579 - `enabled: optional boolean or null`
1580 
1581 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.
1582 
1583 - `left_mouse_down: optional BetaBrowserLeftMouseDownConfig or null`
1584 
1585 `left_mouse_down`'s config overrides.
1586 
1587 - `defer_loading: optional boolean or null`
1588 
1589 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1590 
1591 - `enabled: optional boolean or null`
1592 
1593 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.
1594 
1595 - `left_mouse_up: optional BetaBrowserLeftMouseUpConfig or null`
1596 
1597 `left_mouse_up`'s config overrides.
1598 
1599 - `defer_loading: optional boolean or null`
1600 
1601 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1602 
1603 - `enabled: optional boolean or null`
1604 
1605 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.
1606 
1607 - `list_tabs: optional BetaBrowserListTabsConfig or null`
1608 
1609 `list_tabs`'s config overrides.
1610 
1611 - `defer_loading: optional boolean or null`
1612 
1613 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1614 
1615 - `enabled: optional boolean or null`
1616 
1617 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.
1618 
1619 - `middle_click: optional BetaBrowserMiddleClickConfig or null`
1620 
1621 `middle_click`'s config overrides.
1622 
1623 - `defer_loading: optional boolean or null`
1624 
1625 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1626 
1627 - `enabled: optional boolean or null`
1628 
1629 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.
1630 
1631 - `mouse_move: optional BetaBrowserMouseMoveConfig or null`
1632 
1633 `mouse_move`'s config overrides.
1634 
1635 - `defer_loading: optional boolean or null`
1636 
1637 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1638 
1639 - `enabled: optional boolean or null`
1640 
1641 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.
1642 
1643 - `navigate: optional BetaBrowserNavigateConfig or null`
1644 
1645 `navigate`'s config overrides.
1646 
1647 - `defer_loading: optional boolean or null`
1648 
1649 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1650 
1651 - `enabled: optional boolean or null`
1652 
1653 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.
1654 
1655 - `new_tab: optional BetaBrowserNewTabConfig or null`
1656 
1657 `new_tab`'s config overrides.
1658 
1659 - `defer_loading: optional boolean or null`
1660 
1661 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1662 
1663 - `enabled: optional boolean or null`
1664 
1665 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.
1666 
1667 - `read_console: optional BetaBrowserReadConsoleConfig or null`
1668 
1669 `read_console`'s config overrides.
1670 
1671 - `defer_loading: optional boolean or null`
1672 
1673 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1674 
1675 - `enabled: optional boolean or null`
1676 
1677 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.
1678 
1679 - `read_network: optional BetaBrowserReadNetworkConfig or null`
1680 
1681 `read_network`'s config overrides.
1682 
1683 - `defer_loading: optional boolean or null`
1684 
1685 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1686 
1687 - `enabled: optional boolean or null`
1688 
1689 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.
1690 
1691 - `read_page: optional BetaBrowserReadPageConfig or null`
1692 
1693 `read_page`'s config overrides.
1694 
1695 - `defer_loading: optional boolean or null`
1696 
1697 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1698 
1699 - `enabled: optional boolean or null`
1700 
1701 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.
1702 
1703 - `right_click: optional BetaBrowserRightClickConfig or null`
1704 
1705 `right_click`'s config overrides.
1706 
1707 - `defer_loading: optional boolean or null`
1708 
1709 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1710 
1711 - `enabled: optional boolean or null`
1712 
1713 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.
1714 
1715 - `screenshot: optional BetaBrowserScreenshotConfig or null`
1716 
1717 `screenshot`'s config overrides.
1718 
1719 - `defer_loading: optional boolean or null`
1720 
1721 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1722 
1723 - `enabled: optional boolean or null`
1724 
1725 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.
1726 
1727 - `scroll: optional BetaBrowserScrollConfig or null`
1728 
1729 `scroll`'s config overrides.
1730 
1731 - `defer_loading: optional boolean or null`
1732 
1733 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1734 
1735 - `enabled: optional boolean or null`
1736 
1737 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.
1738 
1739 - `scroll_to: optional BetaBrowserScrollToConfig or null`
1740 
1741 `scroll_to`'s config overrides.
1742 
1743 - `defer_loading: optional boolean or null`
1744 
1745 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1746 
1747 - `enabled: optional boolean or null`
1748 
1749 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.
1750 
1751 - `switch_tab: optional BetaBrowserSwitchTabConfig or null`
1752 
1753 `switch_tab`'s config overrides.
1754 
1755 - `defer_loading: optional boolean or null`
1756 
1757 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1758 
1759 - `enabled: optional boolean or null`
1760 
1761 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.
1762 
1763 - `triple_click: optional BetaBrowserTripleClickConfig or null`
1764 
1765 `triple_click`'s config overrides.
1766 
1767 - `defer_loading: optional boolean or null`
1768 
1769 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1770 
1771 - `enabled: optional boolean or null`
1772 
1773 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.
1774 
1775 - `wait: optional BetaBrowserWaitConfig or null`
1776 
1777 `wait`'s config overrides.
1778 
1779 - `defer_loading: optional boolean or null`
1780 
1781 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1782 
1783 - `enabled: optional boolean or null`
1784 
1785 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.
1786 
1787 - `zoom: optional BetaBrowserZoomConfig or null`
1788 
1789 `zoom`'s config overrides.
1790 
1791 - `defer_loading: optional boolean or null`
1792 
1793 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
1794 
1795 - `enabled: optional boolean or null`
1796 
1797 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.
1798 
1799 - `BetaToolComputerUse20241022 object`
1800 
1801 - `type: "computer_20241022"`
1802 
1803 - `display_height_px: number`
1804 
1805 The height of the display in pixels.
1806 
1807 minimum: 1
1808 
1809 - `display_width_px: number`
1810 
1811 The width of the display in pixels.
1812 
1813 minimum: 1
1814 
1815 - `name: "computer"`
1816 
1817 Name of the tool.
1818 
1819 This is how the tool will be called by the model and in `tool_use` blocks.
1820 
1821 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1822 
1823 - `"direct"`
1824 
1825 - `"code_execution_20250825"`
1826 
1827 - `"code_execution_20260120"`
1828 
1829 - `"code_execution_20260521"`
1830 
1831 - `cache_control: optional BetaCacheControlEphemeral or null`
1832 
1833 Create a cache control breakpoint at this content block.
1834 
1835 - `defer_loading: optional boolean`
1836 
1837 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
1838 
1839 - `display_number: optional number or null`
1840 
1841 The X11 display number (e.g. 0, 1) for the display.
1842 
1843 minimum: 0
1844 
1845 - `input_examples: optional array of map[unknown]`
1846 
1847 - `strict: optional boolean`
1848 
1849 When true, guarantees schema validation on tool names and inputs
1850 
1851 - `BetaMemoryTool20250818 object`
1852 
1853 - `type: "memory_20250818"`
1854 
1855 - `name: "memory"`
1856 
1857 Name of the tool.
1858 
1859 This is how the tool will be called by the model and in `tool_use` blocks.
1860 
1861 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1862 
1863 - `"direct"`
1864 
1865 - `"code_execution_20250825"`
1866 
1867 - `"code_execution_20260120"`
1868 
1869 - `"code_execution_20260521"`
1870 
1871 - `cache_control: optional BetaCacheControlEphemeral or null`
1872 
1873 Create a cache control breakpoint at this content block.
1874 
1875 - `defer_loading: optional boolean`
1876 
1877 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
1878 
1879 - `input_examples: optional array of map[unknown]`
1880 
1881 - `strict: optional boolean`
1882 
1883 When true, guarantees schema validation on tool names and inputs
1884 
1885 - `BetaToolComputerUse20250124 object`
1886 
1887 - `type: "computer_20250124"`
1888 
1889 - `display_height_px: number`
1890 
1891 The height of the display in pixels.
1892 
1893 minimum: 1
1894 
1895 - `display_width_px: number`
1896 
1897 The width of the display in pixels.
1898 
1899 minimum: 1
1900 
1901 - `name: "computer"`
1902 
1903 Name of the tool.
1904 
1905 This is how the tool will be called by the model and in `tool_use` blocks.
1906 
1907 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1908 
1909 - `"direct"`
1910 
1911 - `"code_execution_20250825"`
1912 
1913 - `"code_execution_20260120"`
1914 
1915 - `"code_execution_20260521"`
1916 
1917 - `cache_control: optional BetaCacheControlEphemeral or null`
1918 
1919 Create a cache control breakpoint at this content block.
1920 
1921 - `defer_loading: optional boolean`
1922 
1923 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
1924 
1925 - `display_number: optional number or null`
1926 
1927 The X11 display number (e.g. 0, 1) for the display.
1928 
1929 minimum: 0
1930 
1931 - `input_examples: optional array of map[unknown]`
1932 
1933 - `strict: optional boolean`
1934 
1935 When true, guarantees schema validation on tool names and inputs
1936 
1937 - `BetaToolTextEditor20241022 object`
1938 
1939 - `type: "text_editor_20241022"`
1940 
1941 - `name: "str_replace_editor"`
1942 
1943 Name of the tool.
1944 
1945 This is how the tool will be called by the model and in `tool_use` blocks.
1946 
1947 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1948 
1949 - `"direct"`
1950 
1951 - `"code_execution_20250825"`
1952 
1953 - `"code_execution_20260120"`
1954 
1955 - `"code_execution_20260521"`
1956 
1957 - `cache_control: optional BetaCacheControlEphemeral or null`
1958 
1959 Create a cache control breakpoint at this content block.
1960 
1961 - `defer_loading: optional boolean`
1962 
1963 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
1964 
1965 - `input_examples: optional array of map[unknown]`
1966 
1967 - `strict: optional boolean`
1968 
1969 When true, guarantees schema validation on tool names and inputs
1970 
1971 - `BetaToolComputerUse20251124 object`
1972 
1973 - `type: "computer_20251124"`
1974 
1975 - `display_height_px: number`
1976 
1977 The height of the display in pixels.
1978 
1979 minimum: 1
1980 
1981 - `display_width_px: number`
1982 
1983 The width of the display in pixels.
1984 
1985 minimum: 1
1986 
1987 - `name: "computer"`
1988 
1989 Name of the tool.
1990 
1991 This is how the tool will be called by the model and in `tool_use` blocks.
1992 
1993 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
1994 
1995 - `"direct"`
1996 
1997 - `"code_execution_20250825"`
1998 
1999 - `"code_execution_20260120"`
2000 
2001 - `"code_execution_20260521"`
2002 
2003 - `cache_control: optional BetaCacheControlEphemeral or null`
2004 
2005 Create a cache control breakpoint at this content block.
2006 
2007 - `defer_loading: optional boolean`
2008 
2009 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
2010 
2011 - `display_number: optional number or null`
2012 
2013 The X11 display number (e.g. 0, 1) for the display.
2014 
2015 minimum: 0
2016 
2017 - `enable_zoom: optional boolean`
2018 
2019 Whether to enable an action to take a zoomed-in screenshot of the screen.
2020 
2021 - `input_examples: optional array of map[unknown]`
2022 
2023 - `strict: optional boolean`
2024 
2025 When true, guarantees schema validation on tool names and inputs
2026 
2027 - `BetaComputerToolset20260801 object`
2028 
2029 The computer toolset: a single `tools[]` entry (carrying no
2030 `name`) that declares the computer tool family. The model is
2031 served the family's tool with any members disabled via `configs`
2032 removed from its schema. Every member is enabled by default, zoom
2033 included. The single-tool options `display_number` and
2034 `enable_zoom` are not fields of a toolset entry — it carries only
2035 `type`, `configs`, and `cache_control`; zoom is controlled
2036 via `configs.zoom.enabled`.
2037 
2038 - `type: "computer_toolset_20260801"`
2039 
2040 - `cache_control: optional BetaCacheControlEphemeral or null`
2041 
2042 Create a cache control breakpoint at this content block.
2043 
2044 - `configs: optional BetaComputerToolsetConfigs or null`
2045 
2046 Per-member configuration for `computer_toolset_20260801`: one
2047 optional field per member tool, keyed by the member name — the same
2048 name the member's `tool_use` blocks carry. Every member is an
2049 accepted key, and a member's defaults apply wherever its key is
2050 absent. Unknown keys are rejected: the field set is this toolset
2051 version's complete member set.
2052 
2053 - `type: optional BetaComputerTypeConfig or null`
2054 
2055 `type`'s config overrides.
2056 
2057 - `defer_loading: optional boolean or null`
2058 
2059 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2060 
2061 - `enabled: optional boolean or null`
2062 
2063 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.
2064 
2065 - `cursor_position: optional BetaComputerCursorPositionConfig or null`
2066 
2067 `cursor_position`'s config overrides.
2068 
2069 - `defer_loading: optional boolean or null`
2070 
2071 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2072 
2073 - `enabled: optional boolean or null`
2074 
2075 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.
2076 
2077 - `double_click: optional BetaComputerDoubleClickConfig or null`
2078 
2079 `double_click`'s config overrides.
2080 
2081 - `defer_loading: optional boolean or null`
2082 
2083 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2084 
2085 - `enabled: optional boolean or null`
2086 
2087 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.
2088 
2089 - `hold_key: optional BetaComputerHoldKeyConfig or null`
2090 
2091 `hold_key`'s config overrides.
2092 
2093 - `defer_loading: optional boolean or null`
2094 
2095 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2096 
2097 - `enabled: optional boolean or null`
2098 
2099 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.
2100 
2101 - `key: optional BetaComputerKeyConfig or null`
2102 
2103 `key`'s config overrides.
2104 
2105 - `defer_loading: optional boolean or null`
2106 
2107 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2108 
2109 - `enabled: optional boolean or null`
2110 
2111 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.
2112 
2113 - `left_click: optional BetaComputerLeftClickConfig or null`
2114 
2115 `left_click`'s config overrides.
2116 
2117 - `defer_loading: optional boolean or null`
2118 
2119 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2120 
2121 - `enabled: optional boolean or null`
2122 
2123 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.
2124 
2125 - `left_click_drag: optional BetaComputerLeftClickDragConfig or null`
2126 
2127 `left_click_drag`'s config overrides.
2128 
2129 - `defer_loading: optional boolean or null`
2130 
2131 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2132 
2133 - `enabled: optional boolean or null`
2134 
2135 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.
2136 
2137 - `left_mouse_down: optional BetaComputerLeftMouseDownConfig or null`
2138 
2139 `left_mouse_down`'s config overrides.
2140 
2141 - `defer_loading: optional boolean or null`
2142 
2143 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2144 
2145 - `enabled: optional boolean or null`
2146 
2147 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.
2148 
2149 - `left_mouse_up: optional BetaComputerLeftMouseUpConfig or null`
2150 
2151 `left_mouse_up`'s config overrides.
2152 
2153 - `defer_loading: optional boolean or null`
2154 
2155 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2156 
2157 - `enabled: optional boolean or null`
2158 
2159 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.
2160 
2161 - `middle_click: optional BetaComputerMiddleClickConfig or null`
2162 
2163 `middle_click`'s config overrides.
2164 
2165 - `defer_loading: optional boolean or null`
2166 
2167 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2168 
2169 - `enabled: optional boolean or null`
2170 
2171 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.
2172 
2173 - `mouse_move: optional BetaComputerMouseMoveConfig or null`
2174 
2175 `mouse_move`'s config overrides.
2176 
2177 - `defer_loading: optional boolean or null`
2178 
2179 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2180 
2181 - `enabled: optional boolean or null`
2182 
2183 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.
2184 
2185 - `right_click: optional BetaComputerRightClickConfig or null`
2186 
2187 `right_click`'s config overrides.
2188 
2189 - `defer_loading: optional boolean or null`
2190 
2191 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2192 
2193 - `enabled: optional boolean or null`
2194 
2195 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.
2196 
2197 - `screenshot: optional BetaComputerScreenshotConfig or null`
2198 
2199 `screenshot`'s config overrides.
2200 
2201 - `defer_loading: optional boolean or null`
2202 
2203 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2204 
2205 - `enabled: optional boolean or null`
2206 
2207 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.
2208 
2209 - `scroll: optional BetaComputerScrollConfig or null`
2210 
2211 `scroll`'s config overrides.
2212 
2213 - `defer_loading: optional boolean or null`
2214 
2215 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2216 
2217 - `enabled: optional boolean or null`
2218 
2219 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.
2220 
2221 - `triple_click: optional BetaComputerTripleClickConfig or null`
2222 
2223 `triple_click`'s config overrides.
2224 
2225 - `defer_loading: optional boolean or null`
2226 
2227 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2228 
2229 - `enabled: optional boolean or null`
2230 
2231 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.
2232 
2233 - `wait: optional BetaComputerWaitConfig or null`
2234 
2235 `wait`'s config overrides.
2236 
2237 - `defer_loading: optional boolean or null`
2238 
2239 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2240 
2241 - `enabled: optional boolean or null`
2242 
2243 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.
2244 
2245 - `zoom: optional BetaComputerZoomConfig or null`
2246 
2247 `zoom`'s config overrides.
2248 
2249 - `defer_loading: optional boolean or null`
2250 
2251 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
2252 
2253 - `enabled: optional boolean or null`
2254 
2255 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.
2256 
2257 - `BetaToolTextEditor20250124 object`
2258 
2259 - `type: "text_editor_20250124"`
2260 
2261 - `name: "str_replace_editor"`
2262 
2263 Name of the tool.
2264 
2265 This is how the tool will be called by the model and in `tool_use` blocks.
2266 
2267 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2268 
2269 - `"direct"`
2270 
2271 - `"code_execution_20250825"`
2272 
2273 - `"code_execution_20260120"`
2274 
2275 - `"code_execution_20260521"`
2276 
2277 - `cache_control: optional BetaCacheControlEphemeral or null`
2278 
2279 Create a cache control breakpoint at this content block.
2280 
2281 - `defer_loading: optional boolean`
2282 
2283 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
2284 
2285 - `input_examples: optional array of map[unknown]`
2286 
2287 - `strict: optional boolean`
2288 
2289 When true, guarantees schema validation on tool names and inputs
2290 
2291 - `BetaToolTextEditor20250429 object`
2292 
2293 - `type: "text_editor_20250429"`
2294 
2295 - `name: "str_replace_based_edit_tool"`
2296 
2297 Name of the tool.
2298 
2299 This is how the tool will be called by the model and in `tool_use` blocks.
2300 
2301 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2302 
2303 - `"direct"`
2304 
2305 - `"code_execution_20250825"`
2306 
2307 - `"code_execution_20260120"`
2308 
2309 - `"code_execution_20260521"`
2310 
2311 - `cache_control: optional BetaCacheControlEphemeral or null`
2312 
2313 Create a cache control breakpoint at this content block.
2314 
2315 - `defer_loading: optional boolean`
2316 
2317 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
2318 
2319 - `input_examples: optional array of map[unknown]`
2320 
2321 - `strict: optional boolean`
2322 
2323 When true, guarantees schema validation on tool names and inputs
2324 
2325 - `BetaToolTextEditor20250728 object`
2326 
2327 - `type: "text_editor_20250728"`
2328 
2329 - `name: "str_replace_based_edit_tool"`
2330 
2331 Name of the tool.
2332 
2333 This is how the tool will be called by the model and in `tool_use` blocks.
2334 
2335 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2336 
2337 - `"direct"`
2338 
2339 - `"code_execution_20250825"`
2340 
2341 - `"code_execution_20260120"`
2342 
2343 - `"code_execution_20260521"`
2344 
2345 - `cache_control: optional BetaCacheControlEphemeral or null`
2346 
2347 Create a cache control breakpoint at this content block.
2348 
2349 - `defer_loading: optional boolean`
2350 
2351 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
2352 
2353 - `input_examples: optional array of map[unknown]`
2354 
2355 - `max_characters: optional number or null`
2356 
2357 Maximum number of characters to display when viewing a file. If not specified, defaults to displaying the full file.
2358 
2359 minimum: 1
2360 
2361 - `strict: optional boolean`
2362 
2363 When true, guarantees schema validation on tool names and inputs
2364 
2365 - `BetaWebSearchTool20250305 object`
2366 
2367 - `type: "web_search_20250305"`
2368 
2369 - `name: "web_search"`
2370 
2371 Name of the tool.
2372 
2373 This is how the tool will be called by the model and in `tool_use` blocks.
2374 
2375 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2376 
2377 - `"direct"`
2378 
2379 - `"code_execution_20250825"`
2380 
2381 - `"code_execution_20260120"`
2382 
2383 - `"code_execution_20260521"`
2384 
2385 - `allowed_domains: optional array of string or null`
2386 
2387 If provided, only these domains will be included in results. Cannot be used alongside `blocked_domains`.
2388 
2389 - `blocked_domains: optional array of string or null`
2390 
2391 If provided, these domains will never appear in results. Cannot be used alongside `allowed_domains`.
2392 
2393 - `cache_control: optional BetaCacheControlEphemeral or null`
2394 
2395 Create a cache control breakpoint at this content block.
2396 
2397 - `defer_loading: optional boolean`
2398 
2399 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
2400 
2401 - `max_uses: optional number or null`
2402 
2403 Maximum number of times the tool can be used in the API request.
2404 
2405 exclusiveMinimum: 0
2406 
2407 - `strict: optional boolean`
2408 
2409 When true, guarantees schema validation on tool names and inputs
2410 
2411 - `user_location: optional BetaUserLocation or null`
2412 
2413 Parameters for the user's location. Used to provide more relevant search results.
2414 
2415 - `type: "approximate"`
2416 
2417 - `city: optional string or null`
2418 
2419 The city of the user.
2420 
2421 maxLength: 255, minLength: 1
2422 
2423 - `country: optional string or null`
2424 
2425 The two letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the user.
2426 
2427 maxLength: 2, minLength: 2
2428 
2429 - `region: optional string or null`
2430 
2431 The region of the user.
2432 
2433 maxLength: 255, minLength: 1
2434 
2435 - `timezone: optional string or null`
2436 
2437 The [IANA timezone](https://nodatime.org/TimeZones) of the user.
2438 
2439 maxLength: 255, minLength: 1
2440 
2441 - `BetaWebFetchTool20250910 object`
2442 
2443 - `type: "web_fetch_20250910"`
2444 
2445 - `name: "web_fetch"`
2446 
2447 Name of the tool.
2448 
2449 This is how the tool will be called by the model and in `tool_use` blocks.
2450 
2451 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2452 
2453 - `"direct"`
2454 
2455 - `"code_execution_20250825"`
2456 
2457 - `"code_execution_20260120"`
2458 
2459 - `"code_execution_20260521"`
2460 
2461 - `allowed_domains: optional array of string or null`
2462 
2463 List of domains to allow fetching from
2464 
2465 - `blocked_domains: optional array of string or null`
2466 
2467 List of domains to block fetching from
2468 
2469 - `cache_control: optional BetaCacheControlEphemeral or null`
2470 
2471 Create a cache control breakpoint at this content block.
2472 
2473 - `citations: optional BetaCitationsConfigParam or null`
2474 
2475 Citations configuration for fetched documents. Citations are disabled by default.
2476 
2477 - `enabled: optional boolean`
2478 
2479 - `defer_loading: optional boolean`
2480 
2481 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
2482 
2483 - `max_content_tokens: optional number or null`
2484 
2485 Maximum number of tokens used by including web page text content in the context. The limit is approximate and does not apply to binary content such as PDFs.
2486 
2487 exclusiveMinimum: 0
2488 
2489 - `max_uses: optional number or null`
2490 
2491 Maximum number of times the tool can be used in the API request.
2492 
2493 exclusiveMinimum: 0
2494 
2495 - `strict: optional boolean`
2496 
2497 When true, guarantees schema validation on tool names and inputs
2498 
2499 - `url_sources: optional BetaWebFetchURLSources or null`
2500 
2501 Which sources contribute to the set of URLs web fetch may fetch.
2502 
2503 Each key is a tagged variant: `user_input` is `all` or `none`; the
2504 two tool filters are `all`, `none`, `only` (only the named tools'
2505 results) or `except` (every result but the named tools'). A named tool
2506 must be declared in this request's `tools[]`.
2507 
2508 - `client_tool_results: optional BetaWebFetchURLSourceAll or BetaWebFetchURLSourceNone or BetaWebFetchURLSourceOnly or BetaWebFetchURLSourceExcept`
2509 
2510 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
2511 
2512 - `BetaWebFetchURLSourceAll object`
2513 
2514 The `url_sources` variant under which a source contributes in
2515 full: every result of the tool filter's source, or all user input.
2516 
2517 - `type: "all"`
2518 
2519 - `BetaWebFetchURLSourceNone object`
2520 
2521 The `url_sources` variant under which a source contributes nothing:
2522 no result of the tool filter's source, or no user input.
2523 
2524 - `type: "none"`
2525 
2526 - `BetaWebFetchURLSourceOnly object`
2527 
2528 The tool filter variant under which only the named tools' results
2529 contribute.
2530 
2531 - `type: "only"`
2532 
2533 - `tools: array of BetaWebFetchURLSourceToolReference`
2534 
2535 - `type: "tool_reference"`
2536 
2537 - `name: string`
2538 
2539 - `BetaWebFetchURLSourceExcept object`
2540 
2541 The tool filter variant under which every result but the named
2542 tools' contributes.
2543 
2544 - `type: "except"`
2545 
2546 - `tools: array of BetaWebFetchURLSourceToolReference`
2547 
2548 - `type: "tool_reference"`
2549 
2550 - `name: string`
2551 
2552 - `server_tool_results: optional BetaWebFetchURLSourceAll or BetaWebFetchURLSourceNone or BetaWebFetchURLSourceOnly or BetaWebFetchURLSourceExcept`
2553 
2554 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
2555 
2556 - `BetaWebFetchURLSourceAll object`
2557 
2558 The `url_sources` variant under which a source contributes in
2559 full: every result of the tool filter's source, or all user input.
2560 
2561 - `BetaWebFetchURLSourceNone object`
2562 
2563 The `url_sources` variant under which a source contributes nothing:
2564 no result of the tool filter's source, or no user input.
2565 
2566 - `BetaWebFetchURLSourceOnly object`
2567 
2568 The tool filter variant under which only the named tools' results
2569 contribute.
2570 
2571 - `BetaWebFetchURLSourceExcept object`
2572 
2573 The tool filter variant under which every result but the named
2574 tools' contributes.
2575 
2576 - `user_input: optional BetaWebFetchURLSourceAll or BetaWebFetchURLSourceNone`
2577 
2578 Whether URLs in user messages are fetchable: "all" or "none".
2579 
2580 - `BetaWebFetchURLSourceAll object`
2581 
2582 The `url_sources` variant under which a source contributes in
2583 full: every result of the tool filter's source, or all user input.
2584 
2585 - `BetaWebFetchURLSourceNone object`
2586 
2587 The `url_sources` variant under which a source contributes nothing:
2588 no result of the tool filter's source, or no user input.
2589 
2590 - `BetaWebSearchTool20260209 object`
2591 
2592 - `type: "web_search_20260209"`
2593 
2594 - `name: "web_search"`
2595 
2596 Name of the tool.
2597 
2598 This is how the tool will be called by the model and in `tool_use` blocks.
2599 
2600 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2601 
2602 - `"direct"`
2603 
2604 - `"code_execution_20250825"`
2605 
2606 - `"code_execution_20260120"`
2607 
2608 - `"code_execution_20260521"`
2609 
2610 - `allowed_domains: optional array of string or null`
2611 
2612 If provided, only these domains will be included in results. Cannot be used alongside `blocked_domains`.
2613 
2614 - `blocked_domains: optional array of string or null`
2615 
2616 If provided, these domains will never appear in results. Cannot be used alongside `allowed_domains`.
2617 
2618 - `cache_control: optional BetaCacheControlEphemeral or null`
2619 
2620 Create a cache control breakpoint at this content block.
2621 
2622 - `defer_loading: optional boolean`
2623 
2624 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
2625 
2626 - `max_uses: optional number or null`
2627 
2628 Maximum number of times the tool can be used in the API request.
2629 
2630 exclusiveMinimum: 0
2631 
2632 - `strict: optional boolean`
2633 
2634 When true, guarantees schema validation on tool names and inputs
2635 
2636 - `user_location: optional BetaUserLocation or null`
2637 
2638 Parameters for the user's location. Used to provide more relevant search results.
2639 
2640 - `BetaWebFetchTool20260209 object`
2641 
2642 - `type: "web_fetch_20260209"`
2643 
2644 - `name: "web_fetch"`
2645 
2646 Name of the tool.
2647 
2648 This is how the tool will be called by the model and in `tool_use` blocks.
2649 
2650 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2651 
2652 - `"direct"`
2653 
2654 - `"code_execution_20250825"`
2655 
2656 - `"code_execution_20260120"`
2657 
2658 - `"code_execution_20260521"`
2659 
2660 - `allowed_domains: optional array of string or null`
2661 
2662 List of domains to allow fetching from
2663 
2664 - `blocked_domains: optional array of string or null`
2665 
2666 List of domains to block fetching from
2667 
2668 - `cache_control: optional BetaCacheControlEphemeral or null`
2669 
2670 Create a cache control breakpoint at this content block.
2671 
2672 - `citations: optional BetaCitationsConfigParam or null`
2673 
2674 Citations configuration for fetched documents. Citations are disabled by default.
2675 
2676 - `defer_loading: optional boolean`
2677 
2678 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
2679 
2680 - `max_content_tokens: optional number or null`
2681 
2682 Maximum number of tokens used by including web page text content in the context. The limit is approximate and does not apply to binary content such as PDFs.
2683 
2684 exclusiveMinimum: 0
2685 
2686 - `max_uses: optional number or null`
2687 
2688 Maximum number of times the tool can be used in the API request.
2689 
2690 exclusiveMinimum: 0
2691 
2692 - `strict: optional boolean`
2693 
2694 When true, guarantees schema validation on tool names and inputs
2695 
2696 - `url_sources: optional BetaWebFetchURLSources or null`
2697 
2698 Which sources contribute to the set of URLs web fetch may fetch.
2699 
2700 Each key is a tagged variant: `user_input` is `all` or `none`; the
2701 two tool filters are `all`, `none`, `only` (only the named tools'
2702 results) or `except` (every result but the named tools'). A named tool
2703 must be declared in this request's `tools[]`.
2704 
2705 - `BetaWebFetchTool20260309 object`
2706 
2707 Web fetch tool with use_cache parameter for bypassing cached content.
2708 
2709 - `type: "web_fetch_20260309"`
2710 
2711 - `name: "web_fetch"`
2712 
2713 Name of the tool.
2714 
2715 This is how the tool will be called by the model and in `tool_use` blocks.
2716 
2717 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2718 
2719 - `"direct"`
2720 
2721 - `"code_execution_20250825"`
2722 
2723 - `"code_execution_20260120"`
2724 
2725 - `"code_execution_20260521"`
2726 
2727 - `allowed_domains: optional array of string or null`
2728 
2729 List of domains to allow fetching from
2730 
2731 - `blocked_domains: optional array of string or null`
2732 
2733 List of domains to block fetching from
2734 
2735 - `cache_control: optional BetaCacheControlEphemeral or null`
2736 
2737 Create a cache control breakpoint at this content block.
2738 
2739 - `citations: optional BetaCitationsConfigParam or null`
2740 
2741 Citations configuration for fetched documents. Citations are disabled by default.
2742 
2743 - `defer_loading: optional boolean`
2744 
2745 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
2746 
2747 - `max_content_tokens: optional number or null`
2748 
2749 Maximum number of tokens used by including web page text content in the context. The limit is approximate and does not apply to binary content such as PDFs.
2750 
2751 exclusiveMinimum: 0
2752 
2753 - `max_uses: optional number or null`
2754 
2755 Maximum number of times the tool can be used in the API request.
2756 
2757 exclusiveMinimum: 0
2758 
2759 - `strict: optional boolean`
2760 
2761 When true, guarantees schema validation on tool names and inputs
2762 
2763 - `url_sources: optional BetaWebFetchURLSources or null`
2764 
2765 Which sources contribute to the set of URLs web fetch may fetch.
2766 
2767 Each key is a tagged variant: `user_input` is `all` or `none`; the
2768 two tool filters are `all`, `none`, `only` (only the named tools'
2769 results) or `except` (every result but the named tools'). A named tool
2770 must be declared in this request's `tools[]`.
2771 
2772 - `use_cache: optional boolean`
2773 
2774 Whether to use cached content. Set to false to bypass the cache and fetch fresh content. Only set to false when the user explicitly requests fresh content or when fetching rapidly-changing sources.
2775 
2776 - `BetaWebSearchTool20260318 object`
2777 
2778 - `type: "web_search_20260318"`
2779 
2780 - `name: "web_search"`
2781 
2782 Name of the tool.
2783 
2784 This is how the tool will be called by the model and in `tool_use` blocks.
2785 
2786 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2787 
2788 - `"direct"`
2789 
2790 - `"code_execution_20250825"`
2791 
2792 - `"code_execution_20260120"`
2793 
2794 - `"code_execution_20260521"`
2795 
2796 - `allowed_domains: optional array of string or null`
2797 
2798 If provided, only these domains will be included in results. Cannot be used alongside `blocked_domains`.
2799 
2800 - `blocked_domains: optional array of string or null`
2801 
2802 If provided, these domains will never appear in results. Cannot be used alongside `allowed_domains`.
2803 
2804 - `cache_control: optional BetaCacheControlEphemeral or null`
2805 
2806 Create a cache control breakpoint at this content block.
2807 
2808 - `defer_loading: optional boolean`
2809 
2810 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
2811 
2812 - `max_uses: optional number or null`
2813 
2814 Maximum number of times the tool can be used in the API request.
2815 
2816 exclusiveMinimum: 0
2817 
2818 - `response_inclusion: optional "full" or "excluded"`
2819 
2820 How this tool's result blocks appear in the API response when the result was consumed by a completed code_execution call in the same turn. 'full' returns the complete content (default). 'excluded' drops the nested server_tool_use and result block pair entirely. Results from direct calls, or from code_execution calls that paused before completing, are always returned in full so they can be sent back on the next turn.
2821 
2822 - `"full"`
2823 
2824 - `"excluded"`
2825 
2826 - `strict: optional boolean`
2827 
2828 When true, guarantees schema validation on tool names and inputs
2829 
2830 - `user_location: optional BetaUserLocation or null`
2831 
2832 Parameters for the user's location. Used to provide more relevant search results.
2833 
2834 - `BetaWebFetchTool20260318 object`
2835 
2836 - `type: "web_fetch_20260318"`
2837 
2838 - `name: "web_fetch"`
2839 
2840 Name of the tool.
2841 
2842 This is how the tool will be called by the model and in `tool_use` blocks.
2843 
2844 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
2845 
2846 - `"direct"`
2847 
2848 - `"code_execution_20250825"`
2849 
2850 - `"code_execution_20260120"`
2851 
2852 - `"code_execution_20260521"`
2853 
2854 - `allowed_domains: optional array of string or null`
2855 
2856 List of domains to allow fetching from
2857 
2858 - `blocked_domains: optional array of string or null`
2859 
2860 List of domains to block fetching from
2861 
2862 - `cache_control: optional BetaCacheControlEphemeral or null`
2863 
2864 Create a cache control breakpoint at this content block.
2865 
2866 - `citations: optional BetaCitationsConfigParam or null`
2867 
2868 Citations configuration for fetched documents. Citations are disabled by default.
2869 
2870 - `defer_loading: optional boolean`
2871 
2872 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
2873 
2874 - `max_content_tokens: optional number or null`
2875 
2876 Maximum number of tokens used by including web page text content in the context. The limit is approximate and does not apply to binary content such as PDFs.
2877 
2878 exclusiveMinimum: 0
2879 
2880 - `max_uses: optional number or null`
2881 
2882 Maximum number of times the tool can be used in the API request.
2883 
2884 exclusiveMinimum: 0
2885 
2886 - `response_inclusion: optional "full" or "excluded"`
2887 
2888 How this tool's result blocks appear in the API response when the result was consumed by a completed code_execution call in the same turn. 'full' returns the complete content (default). 'excluded' drops the nested server_tool_use and result block pair entirely. Results from direct calls, or from code_execution calls that paused before completing, are always returned in full so they can be sent back on the next turn.
2889 
2890 - `"full"`
2891 
2892 - `"excluded"`
2893 
2894 - `strict: optional boolean`
2895 
2896 When true, guarantees schema validation on tool names and inputs
2897 
2898 - `url_sources: optional BetaWebFetchURLSources or null`
2899 
2900 Which sources contribute to the set of URLs web fetch may fetch.
2901 
2902 Each key is a tagged variant: `user_input` is `all` or `none`; the
2903 two tool filters are `all`, `none`, `only` (only the named tools'
2904 results) or `except` (every result but the named tools'). A named tool
2905 must be declared in this request's `tools[]`.
2906 
2907 - `use_cache: optional boolean`
2908 
2909 Whether to use cached content. Set to false to bypass the cache and fetch fresh content. Only set to false when the user explicitly requests fresh content or when fetching rapidly-changing sources.
2910 
2911 - `BetaAdvisorTool20260301 object`
2912 
2913 - `type: "advisor_20260301"`
2914 
2915 - `model: Model`
2916 
2917 The model that will complete your prompt.
2918 
2919 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
2920 
2921 - `"claude-fable-5-1" or "claude-opus-5-5" or "claude-mythos-5-1" or 15 more`
2922 
2923 The model that will complete your prompt.
2924 
2925 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
2926 
2927 - `"claude-fable-5-1"`
2928 
2929 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
2930 
2931 - `"claude-opus-5-5"`
2932 
2933 Powerful intelligence for coding, knowledge work, and long-running agents
2934 
2935 - `"claude-mythos-5-1"`
2936 
2937 Our most capable model for cybersecurity and biology research, available through trusted access programs
2938 
2939 - `"claude-sonnet-5"`
2940 
2941 High-performance model for coding and agents
2942 
2943 - `"claude-fable-5"`
2944 
2945 Next generation of intelligence for the hardest knowledge work and coding problems
2946 
2947 - `"claude-mythos-5"`
2948 
2949 Most capable model for cybersecurity and biology research
2950 
2951 - `"claude-opus-5"`
2952 
2953 Powerful intelligence for long-running agents and coding
2954 
2955 - `"claude-opus-4-8"`
2956 
2957 Powerful intelligence for long-running agents and coding
2958 
2959 - `"claude-opus-4-7"`
2960 
2961 Powerful intelligence for long-running agents and coding
2962 
2963 - `"claude-mythos-preview"`
2964 
2965 New class of intelligence, strongest in coding and cybersecurity
2966 
2967 - `"claude-opus-4-6"`
2968 
2969 Powerful intelligence for long-running agents and coding
2970 
2971 - `"claude-sonnet-4-6"`
2972 
2973 Best combination of speed and intelligence
2974 
2975 - `"claude-haiku-4-5"`
2976 
2977 Fastest model with near-frontier intelligence
2978 
2979 - `"claude-haiku-4-5-20251001"`
2980 
2981 Fastest model with near-frontier intelligence
2982 
2983 - `"claude-opus-4-5"`
2984 
2985 Powerful intelligence for long-running agents and coding
2986 
2987 - `"claude-opus-4-5-20251101"`
2988 
2989 Powerful intelligence for long-running agents and coding
2990 
2991 - `"claude-sonnet-4-5"`
2992 
2993 High-performance model for agents and coding
2994 
2995 - `"claude-sonnet-4-5-20250929"`
2996 
2997 High-performance model for agents and coding
2998 
2999 - `string`
3000 
3001 - `name: "advisor"`
3002 
3003 Name of the tool.
3004 
3005 This is how the tool will be called by the model and in `tool_use` blocks.
3006 
3007 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
3008 
3009 - `"direct"`
3010 
3011 - `"code_execution_20250825"`
3012 
3013 - `"code_execution_20260120"`
3014 
3015 - `"code_execution_20260521"`
3016 
3017 - `cache_control: optional BetaCacheControlEphemeral or null`
3018 
3019 Create a cache control breakpoint at this content block.
3020 
3021 - `caching: optional BetaCacheControlEphemeral or null`
3022 
3023 Caching for the advisor's own prompt. When set, each advisor call writes a cache entry at the given TTL so subsequent calls in the same conversation read the stable prefix. When omitted, the advisor prompt is not cached.
3024 
3025 - `defer_loading: optional boolean`
3026 
3027 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
3028 
3029 - `max_tokens: optional number or null`
3030 
3031 Bounds the advisor's total output (thinking + text) per call. When the advisor hits this cap, the returned advisor_result or advisor_redacted_result block carries stop_reason='max_tokens', and a truncation note is appended to the advice text the worker model sees (inside the encrypted blob in redacted mode). When set, the server also emits a remaining-tokens budget block in the advisor's prompt so the advisor self-shapes toward the cap. When omitted, the advisor model's default output cap applies and no budget block is emitted.
3032 
3033 minimum: 1024
3034 
3035 - `max_uses: optional number or null`
3036 
3037 Maximum number of times the tool can be used in the API request.
3038 
3039 exclusiveMinimum: 0
3040 
3041 - `strict: optional boolean`
3042 
3043 When true, guarantees schema validation on tool names and inputs
3044 
3045 - `BetaToolSearchToolBm25_20251119 object`
3046 
3047 - `type: "tool_search_tool_bm25_20251119" or "tool_search_tool_bm25"`
3048 
3049 - `"tool_search_tool_bm25_20251119"`
3050 
3051 - `"tool_search_tool_bm25"`
3052 
3053 - `name: "tool_search_tool_bm25"`
3054 
3055 Name of the tool.
3056 
3057 This is how the tool will be called by the model and in `tool_use` blocks.
3058 
3059 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
3060 
3061 - `"direct"`
3062 
3063 - `"code_execution_20250825"`
3064 
3065 - `"code_execution_20260120"`
3066 
3067 - `"code_execution_20260521"`
3068 
3069 - `cache_control: optional BetaCacheControlEphemeral or null`
3070 
3071 Create a cache control breakpoint at this content block.
3072 
3073 - `defer_loading: optional boolean`
3074 
3075 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
3076 
3077 - `strict: optional boolean`
3078 
3079 When true, guarantees schema validation on tool names and inputs
3080 
3081 - `BetaToolSearchToolRegex20251119 object`
3082 
3083 - `type: "tool_search_tool_regex_20251119" or "tool_search_tool_regex"`
3084 
3085 - `"tool_search_tool_regex_20251119"`
3086 
3087 - `"tool_search_tool_regex"`
3088 
3089 - `name: "tool_search_tool_regex"`
3090 
3091 Name of the tool.
3092 
3093 This is how the tool will be called by the model and in `tool_use` blocks.
3094 
3095 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
3096 
3097 - `"direct"`
3098 
3099 - `"code_execution_20250825"`
3100 
3101 - `"code_execution_20260120"`
3102 
3103 - `"code_execution_20260521"`
3104 
3105 - `cache_control: optional BetaCacheControlEphemeral or null`
3106 
3107 Create a cache control breakpoint at this content block.
3108 
3109 - `defer_loading: optional boolean`
3110 
3111 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
3112 
3113 - `strict: optional boolean`
3114 
3115 When true, guarantees schema validation on tool names and inputs
3116 
3117 - `BetaMCPToolset object`
3118 
3119 Configuration for a group of tools from an MCP server.
3120 
3121 Allows configuring enabled status and defer_loading for all tools
3122 from an MCP server, with optional per-tool overrides.
3123 
3124 - `type: "mcp_toolset"`
3125 
3126 - `mcp_server_name: string`
3127 
3128 Name of the MCP server to configure tools for
3129 
3130 maxLength: 255, minLength: 1
3131 
3132 - `cache_control: optional BetaCacheControlEphemeral or null`
3133 
3134 Create a cache control breakpoint at this content block.
3135 
3136 - `configs: optional map[BetaMCPToolConfig] or null`
3137 
3138 Configuration overrides for specific tools, keyed by tool name
3139 
3140 - `defer_loading: optional boolean`
3141 
3142 - `enabled: optional boolean`
3143 
3144 - `default_config: optional BetaMCPToolDefaultConfig`
3145 
3146 Default configuration applied to all tools from this server
3147 
3148 - `defer_loading: optional boolean`
3149 
3150 - `enabled: optional boolean`
3151 
3152 - `tools: optional array of BetaMCPToolParam or null`
3153 
3154 The server's tool listing, pinned: when present, the server is not asked for its tools before sampling and exactly these entries, with `default_config` and `configs` applied, are the toolset's tools. Copy it from the `mcp_tool_listing` block of an earlier response.
3155 
3156 - `input_schema: map[unknown]`
3157 
3158 The tool's input schema as the MCP server lists it, verbatim.
3159 
3160 - `name: string`
3161 
3162 The tool's name as the MCP server lists it (not prefixed with the server name).
3163 
3164 minLength: 1
3165 
3166 - `description: optional string or null`
3167 
3168 The tool's description as the MCP server lists it.
3169 
3170 - `BetaResponseToolRemovalBlock object`
3171 
3172 An entry of a `compaction` block's `tool_changes`: a tool of the
3173 request's `tools` (or an MCP tool or toolset) that the compacted range
3174 withdrew. Send it back unchanged.
3175 
3176 - `type: "tool_removal"`
3177 
3178 default: tool_removal
3179 
3180 - `tool: BetaResponseToolChangeToolReference or BetaResponseToolChangeMCPToolReference or BetaResponseToolChangeMCPToolsetReference`
3181 
3182 A reference to the withdrawn `tools` entry, MCP tool or MCP toolset.
3183 
3184 - `BetaResponseToolChangeToolReference object`
3185 
3186 Reference to a single tool, by the name the model uses to call it, as
3187 a `compaction` block's `tool_changes` entry reports it: a tool
3188 declared in `tools` or defined by an earlier `tool_addition` block.
3189 Send it back unchanged with the block.
3190 
3191 - `BetaResponseToolChangeMCPToolReference object`
3192 
3193 Reference to a single MCP tool, by its server and its name on that
3194 server, as a `compaction` block's `tool_changes` entry reports it.
3195 Send it back unchanged with the block.
3196 
3197 - `BetaResponseToolChangeMCPToolsetReference object`
3198 
3199 Reference to every tool in the named MCP server's toolset, as a
3200 `compaction` block's `tool_changes` entry reports it. Send it back
3201 unchanged with the block.
3202 
10573203 - `BetaFallbackBlock object`
10583204 
10593205 Marks the point in `content` where one model's output gives way to the next.
from line 3228
10823228 
10833229 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
10843230 
1085 - `"claude-fable-5-1" or "claude-mythos-5-1" or "claude-sonnet-5" or 14 more`
1086 
1087 The model that will complete your prompt.
1088 
1089 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
1090 
1091 - `"claude-fable-5-1"`
1092 
1093 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
1094 
1095 - `"claude-mythos-5-1"`
1096 
1097 Our most capable model for cybersecurity and biology research, available through trusted access programs
1098 
1099 - `"claude-sonnet-5"`
1100 
1101 High-performance model for coding and agents
1102 
1103 - `"claude-fable-5"`
1104 
1105 Next generation of intelligence for the hardest knowledge work and coding problems
1106 
1107 - `"claude-mythos-5"`
1108 
1109 Most capable model for cybersecurity and biology research
1110 
1111 - `"claude-opus-5"`
1112 
1113 Powerful intelligence for long-running agents and coding
1114 
1115 - `"claude-opus-4-8"`
1116 
1117 Powerful intelligence for long-running agents and coding
1118 
1119 - `"claude-opus-4-7"`
1120 
1121 Powerful intelligence for long-running agents and coding
1122 
1123 - `"claude-mythos-preview"`
1124 
1125 New class of intelligence, strongest in coding and cybersecurity
1126 
1127 - `"claude-opus-4-6"`
1128 
1129 Powerful intelligence for long-running agents and coding
1130 
1131 - `"claude-sonnet-4-6"`
1132 
1133 Best combination of speed and intelligence
1134 
1135 - `"claude-haiku-4-5"`
1136 
1137 Fastest model with near-frontier intelligence
1138 
1139 - `"claude-haiku-4-5-20251001"`
1140 
1141 Fastest model with near-frontier intelligence
1142 
1143 - `"claude-opus-4-5"`
1144 
1145 Powerful intelligence for long-running agents and coding
1146 
1147 - `"claude-opus-4-5-20251101"`
1148 
1149 Powerful intelligence for long-running agents and coding
1150 
1151 - `"claude-sonnet-4-5"`
1152 
1153 High-performance model for agents and coding
1154 
1155 - `"claude-sonnet-4-5-20250929"`
1156 
1157 High-performance model for agents and coding
1158 
1159 - `string`
1160 
11613231 - `to: BetaFallbackInfo`
11623232 
11633233 The fallback model producing the content that follows this block. Its `model` is always the canonical id.
from line 3263
11933263 - `"general_harms"`
11943264 
11953265 The request could be related to an area that was determined as harmful. Benign work might sometimes trigger this category.
3266 
3267 - `BetaMCPToolListingBlock object`
3268 
3269 The tool listing the server fetched from an MCP server while producing
3270 this response. Send the assistant message back unchanged, this block
3271 included, so later requests use this listing instead of asking the MCP
3272 server again.
3273 
3274 - `type: "mcp_tool_listing"`
3275 
3276 default: mcp_tool_listing
3277 
3278 - `mcp_server_name: string`
3279 
3280 - `tools: array of BetaMCPTool`
3281 
3282 - `input_schema: map[unknown]`
3283 
3284 - `name: string`
3285 
3286 - `description: optional string`
11963287 
11973288 - `context_management: BetaContextManagementResponse or null`
11983289 
11993290 
Feedback