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

Beta changedapi/beta

Nearest release: v2.1.283, published 3 hours after 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+5,515added
Lines−5,691removed
From line 459 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits19to this page, all time

The whole hunk

from line 459, old and new numbered
/
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 459
459459 
460460 Defaults to `20`. Ranges from `1` to `1000`.
461461 
462 default: 20, maximum: 1000, minimum: 1
462 default: 20, minimum: 1, maximum: 1000
463463 
464464#### Headers
465465 
from line 595
595595 
596596 - `capabilities: BetaModelCapabilities or null`
597597 
598 Model capability information.
598 Object mapping capability names to their support details. Keys are always present for all known capabilities.
599599 
600600 - `batch: BetaCapabilitySupport`
601601 
from line 615
615615 
616616 - `compaction: BetaCompactionCapability or null`
617617 
618 Compaction capability details: whether the model accepts the top-level
619 `compaction` request parameter, with one entry per supported
620 `compaction.type` value.
618 Server-side compaction support (the top-level `compaction` parameter) and the accepted `compaction.type` values.
621619 
622620 - `summarize: BetaCapabilitySupport`
623621 
from line 631
633631 
634632 - `clear_thinking_20251015: BetaCapabilitySupport or null`
635633 
636 Indicates whether a capability is supported.
634 Whether the clear_thinking_20251015 strategy is supported.
637635 
638636 - `clear_tool_uses_20250919: BetaCapabilitySupport or null`
639637 
640 Indicates whether a capability is supported.
638 Whether the clear_tool_uses_20250919 strategy is supported.
641639 
642640 - `compact_20260112: BetaCapabilitySupport or null`
643641 
644 Indicates whether a capability is supported.
642 Whether the compact_20260112 strategy is supported.
645643 
646644 - `supported: boolean`
647645 
from line 671
673671 
674672 - `xhigh: BetaCapabilitySupport or null`
675673 
676 Indicates whether a capability is supported.
674 Whether the model supports xhigh effort level.
677675 
678676 - `image_input: BetaCapabilitySupport`
679677 
from line 981
983981 
984982 - `capabilities: BetaModelCapabilities or null`
985983 
986 Model capability information.
984 Object mapping capability names to their support details. Keys are always present for all known capabilities.
987985 
988986 - `batch: BetaCapabilitySupport`
989987 
from line 1001
10031001 
10041002 - `compaction: BetaCompactionCapability or null`
10051003 
1006 Compaction capability details: whether the model accepts the top-level
1007 `compaction` request parameter, with one entry per supported
1008 `compaction.type` value.
1004 Server-side compaction support (the top-level `compaction` parameter) and the accepted `compaction.type` values.
10091005 
10101006 - `summarize: BetaCapabilitySupport`
10111007 
from line 1017
10211017 
10221018 - `clear_thinking_20251015: BetaCapabilitySupport or null`
10231019 
1024 Indicates whether a capability is supported.
1020 Whether the clear_thinking_20251015 strategy is supported.
10251021 
10261022 - `clear_tool_uses_20250919: BetaCapabilitySupport or null`
10271023 
1028 Indicates whether a capability is supported.
1024 Whether the clear_tool_uses_20250919 strategy is supported.
10291025 
10301026 - `compact_20260112: BetaCapabilitySupport or null`
10311027 
1032 Indicates whether a capability is supported.
1028 Whether the compact_20260112 strategy is supported.
10331029 
10341030 - `supported: boolean`
10351031 
from line 1057
10611057 
10621058 - `xhigh: BetaCapabilitySupport or null`
10631059 
1064 Indicates whether a capability is supported.
1060 Whether the model supports xhigh effort level.
10651061 
10661062 - `image_input: BetaCapabilitySupport`
10671063 
from line 1442
14461442 
14471443 - `document_title: string or null`
14481444 
1449 maxLength: 500, minLength: 1
1445 minLength: 1, maxLength: 500
14501446 
14511447 - `end_char_index: number`
14521448 
from line 1462
14661462 
14671463 - `document_title: string or null`
14681464 
1469 maxLength: 500, minLength: 1
1465 minLength: 1, maxLength: 500
14701466 
14711467 - `end_page_number: number`
14721468 
from line 1486
14901486 
14911487 - `document_title: string or null`
14921488 
1493 maxLength: 500, minLength: 1
1489 minLength: 1, maxLength: 500
14941490 
14951491 - `end_block_index: number`
14961492 
from line 1510
15141510 
15151511 - `title: string or null`
15161512 
1517 maxLength: 512, minLength: 1
1513 minLength: 1, maxLength: 512
15181514 
15191515 - `url: string`
15201516 
from line 1666
16701666 
16711667 - `title: optional string or null`
16721668 
1673 maxLength: 500, minLength: 1
1669 minLength: 1, maxLength: 500
16741670 
16751671 - `BetaSearchResultBlockParam object`
16761672 
from line 1730
17341730 
17351731 - `name: string`
17361732 
1737 maxLength: 200, minLength: 1
1733 minLength: 1, maxLength: 200
17381734 
17391735 - `cache_control: optional BetaCacheControlEphemeral or null`
17401736 
from line 1766
17701766 
17711767 For a toolset member tool_use, the toolset family this member belongs to.
17721768 
1773 maxLength: 64, minLength: 1, pattern: ^[a-zA-Z0-9_-]+$
1769 minLength: 1, maxLength: 64, pattern: ^[a-zA-Z0-9_-]+$
17741770 
17751771 - `BetaToolResultBlockParam object`
17761772 
from line 1802
18061802 
18071803 - `tool_name: string`
18081804 
1809 maxLength: 256, minLength: 1, pattern: ^[a-zA-Z0-9_-]{1,256}$
1805 minLength: 1, maxLength: 256, pattern: ^[a-zA-Z0-9_-]{1,256}$
18101806 
18111807 - `cache_control: optional BetaCacheControlEphemeral or null`
18121808 
from line 1830
18341830 
18351831 The caller-assigned identifier for this tab, unique within the inventory.
18361832 
1837 maxLength: 4096, minLength: 1, pattern: ^[^\x00-\x1f\x7f-\x9f\u2028\u2029]*$
1833 minLength: 1, maxLength: 4096, pattern: ^[^\x00-\x1f\x7f-\x9f\u2028\u2029]*$
18381834 
18391835 - `title: string`
18401836 
from line 1856
18601856 
18611857 Tabs opened and download state changes during this call. "Nothing to report" is expressed by omitting the field, never by an empty list.
18621858 
1863 maxItems: 200, minItems: 1
1859 minItems: 1, maxItems: 200
18641860 
18651861 - `BetaBrowserStateChangeTabOpened object`
18661862 
from line 1874
18781874 
18791875 The `tab_id` of the opened tab, present in `tabs`.
18801876 
1881 maxLength: 4096, minLength: 1, pattern: ^[^\x00-\x1f\x7f-\x9f\u2028\u2029]*$
1877 minLength: 1, maxLength: 4096, pattern: ^[^\x00-\x1f\x7f-\x9f\u2028\u2029]*$
18821878 
18831879 - `BetaBrowserStateChangeDownloadStarted object`
18841880 
from line 1886
18901886 
18911887 The caller-assigned identifier for this download, stable across the state changes reporting it.
18921888 
1893 maxLength: 4096, minLength: 1, pattern: ^[^\x00-\x1f\x7f-\x9f\u2028\u2029]*$
1889 minLength: 1, maxLength: 4096, pattern: ^[^\x00-\x1f\x7f-\x9f\u2028\u2029]*$
18941890 
18951891 - `url: string`
18961892 
from line 1907
19111907 
19121908 The caller-assigned identifier for this download, stable across the state changes reporting it.
19131909 
1914 maxLength: 4096, minLength: 1, pattern: ^[^\x00-\x1f\x7f-\x9f\u2028\u2029]*$
1910 minLength: 1, maxLength: 4096, pattern: ^[^\x00-\x1f\x7f-\x9f\u2028\u2029]*$
19151911 
19161912 - `url: string`
19171913 
from line 1919
19231919 
19241920 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.
19251921 
1926 pattern: ^[^\x00-\x1f\x7f-\x9f\u2028\u2029]*$, maxLength: 4096
1922 maxLength: 4096, pattern: ^[^\x00-\x1f\x7f-\x9f\u2028\u2029]*$
19271923 
19281924 - `size_bytes: optional number or null`
19291925 
from line 1937
19411937 
19421938 The caller-assigned identifier for this download, stable across the state changes reporting it.
19431939 
1944 maxLength: 4096, minLength: 1, pattern: ^[^\x00-\x1f\x7f-\x9f\u2028\u2029]*$
1940 minLength: 1, maxLength: 4096, pattern: ^[^\x00-\x1f\x7f-\x9f\u2028\u2029]*$
19451941 
19461942 - `url: string`
19471943 
from line 1949
19531949 
19541950 The failure or cancellation detail, when known.
19551951 
1956 pattern: ^[^\x00-\x1f\x7f-\x9f\u2028\u2029]*$, maxLength: 4096
1952 maxLength: 4096, pattern: ^[^\x00-\x1f\x7f-\x9f\u2028\u2029]*$
19571953 
19581954 - `is_error: optional boolean`
19591955 
from line 1957
19611957 
19621958 For a toolset member tool_result, the toolset family of the paired tool_use.
19631959 
1964 maxLength: 64, minLength: 1, pattern: ^[a-zA-Z0-9_-]+$
1960 minLength: 1, maxLength: 64, pattern: ^[a-zA-Z0-9_-]+$
19651961 
19661962 - `BetaServerToolUseBlockParam object`
19671963 
from line 2389
23932389 
23942390 - `tool_name: string`
23952391 
2396 maxLength: 256, minLength: 1, pattern: ^[a-zA-Z0-9_-]{1,256}$
2392 minLength: 1, maxLength: 256, pattern: ^[a-zA-Z0-9_-]{1,256}$
23972393 
23982394 - `cache_control: optional BetaCacheControlEphemeral or null`
23992395 
from line 2581
25852581 
25862582 This is how the tool will be called by the model and in `tool_use` blocks.
25872583 
2588 maxLength: 128, minLength: 1, pattern: ^[a-zA-Z0-9_-]{1,128}$
2584 minLength: 1, maxLength: 128, pattern: ^[a-zA-Z0-9_-]{1,128}$
25892585 
25902586 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
25912587 
from line 2832
28362832 
28372833 - `configs: optional BetaBrowserToolsetConfigs or null`
28382834 
2839 Per-member configuration for `browser_toolset_20260801`: one
2840 optional field per member tool, keyed by the member name — the same
2841 name the member's `tool_use` blocks carry. Every member is an
2842 accepted key, and a member's defaults apply wherever its key is
2843 absent. Unknown keys are rejected: the field set is this toolset
2844 version's complete member set.
2835 Sparse per-member overrides, keyed by member name. Absent, null, and {} are equivalent; a member's defaults apply wherever its key is absent.
28452836 
28462837 - `type: optional BetaBrowserTypeConfig or null`
28472838 
from line 3453
34623453 
34633454 - `configs: optional BetaComputerToolsetConfigs or null`
34643455 
3465 Per-member configuration for `computer_toolset_20260801`: one
3466 optional field per member tool, keyed by the member name — the same
3467 name the member's `tool_use` blocks carry. Every member is an
3468 accepted key, and a member's defaults apply wherever its key is
3469 absent. Unknown keys are rejected: the field set is this toolset
3470 version's complete member set.
3456 Sparse per-member overrides, keyed by member name. Absent, null, and {} are equivalent; a member's defaults apply wherever its key is absent.
34713457 
34723458 - `type: optional BetaComputerTypeConfig or null`
34733459 
from line 3807
38213807 
38223808 Maximum number of times the tool can be used in the API request.
38233809 
3824 exclusiveMinimum: 0
3810 minimum: 1
38253811 
38263812 - `strict: optional boolean`
38273813 
from line 3823
38373823 
38383824 The city of the user.
38393825 
3840 maxLength: 255, minLength: 1
3826 minLength: 1, maxLength: 255
38413827 
38423828 - `country: optional string or null`
38433829 
38443830 The two letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the user.
38453831 
3846 maxLength: 2, minLength: 2
3832 minLength: 2, maxLength: 2
38473833 
38483834 - `region: optional string or null`
38493835 
38503836 The region of the user.
38513837 
3852 maxLength: 255, minLength: 1
3838 minLength: 1, maxLength: 255
38533839 
38543840 - `timezone: optional string or null`
38553841 
38563842 The [IANA timezone](https://nodatime.org/TimeZones) of the user.
38573843 
3858 maxLength: 255, minLength: 1
3844 minLength: 1, maxLength: 255
38593845 
38603846 - `BetaWebFetchTool20250910 object`
38613847 
from line 3887
39013887 
39023888 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.
39033889 
3904 exclusiveMinimum: 0
3890 minimum: 1
39053891 
39063892 - `max_uses: optional number or null`
39073893 
39083894 Maximum number of times the tool can be used in the API request.
39093895 
3910 exclusiveMinimum: 0
3896 minimum: 1
39113897 
39123898 - `strict: optional boolean`
39133899 
from line 3901
39153901 
39163902 - `url_sources: optional BetaWebFetchURLSources or null`
39173903 
3918 Which sources contribute to the set of URLs web fetch may fetch.
3904 Which sources contribute to the set of URLs the tool may fetch. Omitted means every source.
39193905 
3920 Each key is a tagged variant: `user_input` is `all` or `none`; the
3921 two tool filters are `all`, `none`, `only` (only the named tools'
3922 results) or `except` (every result but the named tools'). A named tool
3923 must be declared in this request's `tools[]`.
3924 
39253906 - `client_tool_results: optional BetaWebFetchURLSourceAll or BetaWebFetchURLSourceNone or BetaWebFetchURLSourceOnly or BetaWebFetchURLSourceExcept`
39263907 
39273908 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
from line 4025
40444025 
40454026 Maximum number of times the tool can be used in the API request.
40464027 
4047 exclusiveMinimum: 0
4028 minimum: 1
40484029 
40494030 - `strict: optional boolean`
40504031 
from line 4079
40984079 
40994080 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.
41004081 
4101 exclusiveMinimum: 0
4082 minimum: 1
41024083 
41034084 - `max_uses: optional number or null`
41044085 
41054086 Maximum number of times the tool can be used in the API request.
41064087 
4107 exclusiveMinimum: 0
4088 minimum: 1
41084089 
41094090 - `strict: optional boolean`
41104091 
from line 4093
41124093 
41134094 - `url_sources: optional BetaWebFetchURLSources or null`
41144095 
4115 Which sources contribute to the set of URLs web fetch may fetch.
4096 Which sources contribute to the set of URLs the tool may fetch. Omitted means every source.
41164097 
4117 Each key is a tagged variant: `user_input` is `all` or `none`; the
4118 two tool filters are `all`, `none`, `only` (only the named tools'
4119 results) or `except` (every result but the named tools'). A named tool
4120 must be declared in this request's `tools[]`.
4121 
41224098 - `BetaWebFetchTool20260309 object`
41234099 
41244100 Web fetch tool with use_cache parameter for bypassing cached content.
from line 4141
41654141 
41664142 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.
41674143 
4168 exclusiveMinimum: 0
4144 minimum: 1
41694145 
41704146 - `max_uses: optional number or null`
41714147 
41724148 Maximum number of times the tool can be used in the API request.
41734149 
4174 exclusiveMinimum: 0
4150 minimum: 1
41754151 
41764152 - `strict: optional boolean`
41774153 
from line 4155
41794155 
41804156 - `url_sources: optional BetaWebFetchURLSources or null`
41814157 
4182 Which sources contribute to the set of URLs web fetch may fetch.
4158 Which sources contribute to the set of URLs the tool may fetch. Omitted means every source.
41834159 
4184 Each key is a tagged variant: `user_input` is `all` or `none`; the
4185 two tool filters are `all`, `none`, `only` (only the named tools'
4186 results) or `except` (every result but the named tools'). A named tool
4187 must be declared in this request's `tools[]`.
4188 
41894160 - `use_cache: optional boolean`
41904161 
41914162 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.
from line 4201
42304201 
42314202 Maximum number of times the tool can be used in the API request.
42324203 
4233 exclusiveMinimum: 0
4204 minimum: 1
42344205 
42354206 - `response_inclusion: optional "full" or "excluded"`
42364207 
from line 4263
42924263 
42934264 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.
42944265 
4295 exclusiveMinimum: 0
4266 minimum: 1
42964267 
42974268 - `max_uses: optional number or null`
42984269 
42994270 Maximum number of times the tool can be used in the API request.
43004271 
4301 exclusiveMinimum: 0
4272 minimum: 1
43024273 
43034274 - `response_inclusion: optional "full" or "excluded"`
43044275 
from line 4285
43144285 
43154286 - `url_sources: optional BetaWebFetchURLSources or null`
43164287 
4317 Which sources contribute to the set of URLs web fetch may fetch.
4288 Which sources contribute to the set of URLs the tool may fetch. Omitted means every source.
43184289 
4319 Each key is a tagged variant: `user_input` is `all` or `none`; the
4320 two tool filters are `all`, `none`, `only` (only the named tools'
4321 results) or `except` (every result but the named tools'). A named tool
4322 must be declared in this request's `tools[]`.
4323 
43244290 - `use_cache: optional boolean`
43254291 
43264292 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.
from line 4301
43354301 
43364302 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
43374303 
4304 - `string`
4305 
43384306 - `"claude-fable-5-1" or "claude-opus-5-5" or "claude-mythos-5-1" or 15 more`
43394307 
43404308 The model that will complete your prompt.
from line 4345
43774345 
43784346 Powerful intelligence for long-running agents and coding
43794347 
4380 - `"claude-mythos-preview"`
4381 
4382 New class of intelligence, strongest in coding and cybersecurity
4383 
43844348 - `"claude-opus-4-6"`
43854349 
43864350 Powerful intelligence for long-running agents and coding
from line 4377
44134377 
44144378 High-performance model for agents and coding
44154379 
4416 - `string`
4380 - `"claude-mythos-preview"`
44174381 
4382 **Deprecated**: Will reach end-of-life on June 30, 2026. Please migrate to claude-mythos-5. Visit https://docs.anthropic.com/en/docs/resources/model-deprecations for more information.
4383 
4384 New class of intelligence, strongest in coding and cybersecurity
4385 
44184386 - `name: "advisor"`
44194387 
44204388 Name of the tool.
from line 4421
44534421 
44544422 Maximum number of times the tool can be used in the API request.
44554423 
4456 exclusiveMinimum: 0
4424 minimum: 1
44574425 
44584426 - `strict: optional boolean`
44594427 
from line 4512
45444512 
45454513 Name of the MCP server to configure tools for
45464514 
4547 maxLength: 255, minLength: 1
4515 minLength: 1, maxLength: 255
45484516 
45494517 - `cache_control: optional BetaCacheControlEphemeral or null`
45504518 
from line 4622
46544622 
46554623 The name of the MCP server this listing came from, as `mcp_servers` declares it.
46564624 
4657 maxLength: 255, minLength: 1
4625 minLength: 1, maxLength: 255
46584626 
46594627 - `tools: array of BetaMCPToolParam`
46604628 
from line 4704
47364704 
47374705 - `effort: optional "low" or "medium" or "high" or 2 more or null`
47384706 
4739 All possible effort levels.
4707 How much effort the model should put into its response. Higher effort levels may result in more thorough analysis but take longer.
47404708 
4709 Valid values are `low`, `medium`, `high`, `xhigh`, or `max`.
4710 
47414711 - `"low"`
47424712 
47434713 - `"medium"`
from line 4730
47604730 
47614731- `compaction: optional BetaCompactionConfig or null`
47624732 
4763 Compact the whole conversation and return a signed `compaction` block,
4764 alone, that a later request sends back first in `messages`, in place of
4765 the messages it summarizes. There is no trigger and no pause flag: sending
4766 the parameter compacts, and nothing is sampled after the block.
4733 Compaction configuration.
47674734 
4768 The summarization prompt is the server's own unless `instructions` are
4769 given, which then replace it for this request; a value that is empty or
4770 only whitespace counts as absent.
4735 When set on `POST /v1/messages`, the request is a compaction request: the conversation in `messages` is summarized and the response holds only the resulting `compaction` block (`stop_reason` `"compaction"`), which later requests send first in `messages` in place of the messages it summarizes. `POST /v1/messages/count_tokens` accepts this parameter and ignores it: the count it returns is for the conversation in `messages` as sent. Cannot be combined with `context_management`.
47714736 
47724737 - `type: "summarize"`
47734738 
from line 4772
48074772 
48084773 Skill ID
48094774 
4810 maxLength: 64, minLength: 1
4775 minLength: 1, maxLength: 64
48114776 
48124777 - `version: optional string`
48134778 
48144779 Skill version or 'latest' for most recent version
48154780 
4816 maxLength: 64, minLength: 1
4781 minLength: 1, maxLength: 64
48174782 
48184783 - `string`
48194784 
from line 4792
48274792 
48284793 List of context management edits to apply
48294794 
4830 minItems: 0
4831 
48324795 - `BetaClearToolUses20250919Edit object`
48334796 
48344797 - `type: "clear_tool_uses_20250919"`
from line 4890
49274890 
49284891- `diagnostics: optional BetaDiagnosticsParam or null`
49294892 
4930 Request-level diagnostics. Currently carries the previous response
4931 id for prompt-cache divergence reporting.
4893 Request-level diagnostics. Supply `previous_message_id` to have the response include `diagnostics.cache_miss_reason` explaining any prompt-cache divergence from that prior request.
49324894 
49334895 - `previous_message_id: optional string or null`
49344896 
from line 4937
49754937 
49764938 The opaque `fallback_credit_token` from a prior refusal's `stop_details` — the same string the bare-string form carries.
49774939 
4978 maxLength: 2048, minLength: 1
4940 minLength: 1, maxLength: 2048
49794941 
49804942 - `mode: optional "strict" or "best_effort"`
49814943 
from line 4965
50034965 
50044966 - `effort: optional "low" or "medium" or "high" or 2 more or null`
50054967 
5006 All possible effort levels.
4968 How much effort the model should put into its response. Higher effort levels may result in more thorough analysis but take longer.
50074969 
4970 Valid values are `low`, `medium`, `high`, `xhigh`, or `max`.
4971 
50084972 - `"low"`
50094973 
50104974 - `"medium"`
from line 4991
50274991 
50284992 - `task_budget: optional BetaTokenTaskBudget or null`
50294993 
5030 User-configurable total token budget across contexts.
4994 Configuration for token budget tracking across contexts.
50314995 
50324996 - `type: "tokens"`
50334997 
from line 5035
50715035 
50725036 - `block_binding: optional BetaThinkingBlockBinding or null`
50735037 
5074 Controls for block binding: what happens when a thinking block this
5075 request sends back fails the conversation check. Every field is optional;
5076 an empty object means every default.
5038 Controls for block binding: what happens when a thinking block this request sends back fails the conversation check. `null`, absent or an empty object means every default.
50775039 
50785040 - `prefix_mismatch_behavior: optional BetaThinkingPrefixMismatchBehavior or null`
50795041 
5080 What happens when a thinking block in `messages` fails the conversation
5081 check: it was created in a different conversation, or the messages before
5082 it have changed since. `"error"` (the default) fails the request with a
5083 400 error. `"drop_block"` removes the failing blocks and the request
5084 proceeds; the model no longer sees the dropped reasoning.
5042 "error" (default) | "drop_block". What happens when a thinking block in `messages` fails the conversation check (it was created in a different conversation, or the messages before it have changed since). "error" fails the request with a 400 error. "drop_block" removes the failing blocks and the request proceeds; each removal is reported in `input_transformations`.
50855043 
50865044 - `"error"`
50875045 
from line 5065
51075065 
51085066 - `block_binding: optional BetaThinkingBlockBinding or null`
51095067 
5110 Controls for block binding: what happens when a thinking block this
5111 request sends back fails the conversation check. Every field is optional;
5112 an empty object means every default.
5068 Controls for block binding: what happens when a thinking block this request sends back fails the conversation check. `null`, absent or an empty object means every default.
51135069 
51145070 - `display: optional "summarized" or "omitted" or "updates" or null`
51155071 
from line 5131
51755131 
51765132- `speed: optional "standard" or "fast" or null`
51775133 
5178 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
5134 The inference speed mode for this request. `"fast"` enables high output-tokens-per-second inference.
51795135 
51805136 - `"standard"`
51815137 
from line 5400
54445400 
54455401 Note that even with `temperature` of `0.0`, the results will not be fully deterministic.
54465402 
5447 maximum: 1, minimum: 0
5403 minimum: 0, maximum: 1
54485404 
54495405- `top_k: optional number`
54505406 
from line 5424
54685424 
54695425 Recommended for advanced use cases only.
54705426 
5471 maximum: 1, minimum: 0
5427 minimum: 0, maximum: 1
54725428 
54735429#### Returns
54745430 
from line 5446
54905446 
54915447 - `container: BetaContainer or null`
54925448 
5493 Information about the container used in the request (for the code execution tool)
5449 Information about the container used in this request.
54945450 
5451 This will be non-null if a container tool (e.g. code execution) was used.
5452 
54955453 - `id: string`
54965454 
54975455 Identifier for the container used in this request
from line 5476
55185476 
55195477 Skill ID
55205478 
5521 maxLength: 64, minLength: 1
5479 minLength: 1, maxLength: 64
55225480 
55235481 - `version: string`
55245482 
55255483 The resolved version: a skill version ID for custom skills.
55265484 
5527 maxLength: 64, minLength: 1
5485 minLength: 1, maxLength: 64
55285486 
55295487 - `content: array of BetaContentBlock`
55305488 
from line 5655
56975655 
56985656 - `text: string`
56995657 
5700 minLength: 0
5701 
57025658 - `BetaThinkingBlock object`
57035659 
57045660 - `type: "thinking"`
from line 5733
57775733 
57785734 For a toolset member tool_use, the toolset family.
57795735 
5780 maxLength: 64, minLength: 1, pattern: ^[a-zA-Z0-9_-]+$
5736 minLength: 1, maxLength: 64, pattern: ^[a-zA-Z0-9_-]+$
57815737 
57825738 - `BetaServerToolUseBlock object`
57835739 
from line 6237
62816237 
62826238 - `tool_name: string`
62836239 
6284 maxLength: 256, minLength: 1, pattern: ^[a-zA-Z0-9_-]{1,256}$
6240 minLength: 1, maxLength: 256, pattern: ^[a-zA-Z0-9_-]{1,256}$
62856241 
62866242 - `tool_use_id: string`
62876243 
from line 6287
63316287 
63326288 - `text: string`
63336289 
6334 minLength: 0
6335 
63366290 - `is_error: boolean`
63376291 
63386292 default: false
from line 6424
64706424 
64716425 This is how the tool will be called by the model and in `tool_use` blocks.
64726426 
6473 maxLength: 128, minLength: 1, pattern: ^[a-zA-Z0-9_-]{1,128}$
6427 minLength: 1, maxLength: 128, pattern: ^[a-zA-Z0-9_-]{1,128}$
64746428 
64756429 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
64766430 
from line 6688
67346688 
67356689 - `configs: optional BetaBrowserToolsetConfigs or null`
67366690 
6737 Per-member configuration for `browser_toolset_20260801`: one
6738 optional field per member tool, keyed by the member name — the same
6739 name the member's `tool_use` blocks carry. Every member is an
6740 accepted key, and a member's defaults apply wherever its key is
6741 absent. Unknown keys are rejected: the field set is this toolset
6742 version's complete member set.
6691 Sparse per-member overrides, keyed by member name. Absent, null, and {} are equivalent; a member's defaults apply wherever its key is absent.
67436692 
67446693 - `type: optional BetaBrowserTypeConfig or null`
67456694 
from line 7309
73607309 
73617310 - `configs: optional BetaComputerToolsetConfigs or null`
73627311 
7363 Per-member configuration for `computer_toolset_20260801`: one
7364 optional field per member tool, keyed by the member name — the same
7365 name the member's `tool_use` blocks carry. Every member is an
7366 accepted key, and a member's defaults apply wherever its key is
7367 absent. Unknown keys are rejected: the field set is this toolset
7368 version's complete member set.
7312 Sparse per-member overrides, keyed by member name. Absent, null, and {} are equivalent; a member's defaults apply wherever its key is absent.
73697313 
73707314 - `type: optional BetaComputerTypeConfig or null`
73717315 
from line 7663
77197663 
77207664 Maximum number of times the tool can be used in the API request.
77217665 
7722 exclusiveMinimum: 0
7666 minimum: 1
77237667 
77247668 - `strict: optional boolean`
77257669 
from line 7679
77357679 
77367680 The city of the user.
77377681 
7738 maxLength: 255, minLength: 1
7682 minLength: 1, maxLength: 255
77397683 
77407684 - `country: optional string or null`
77417685 
77427686 The two letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the user.
77437687 
7744 maxLength: 2, minLength: 2
7688 minLength: 2, maxLength: 2
77457689 
77467690 - `region: optional string or null`
77477691 
77487692 The region of the user.
77497693 
7750 maxLength: 255, minLength: 1
7694 minLength: 1, maxLength: 255
77517695 
77527696 - `timezone: optional string or null`
77537697 
77547698 The [IANA timezone](https://nodatime.org/TimeZones) of the user.
77557699 
7756 maxLength: 255, minLength: 1
7700 minLength: 1, maxLength: 255
77577701 
77587702 - `BetaWebFetchTool20250910 object`
77597703 
from line 7713
77697713 
77707714 - `"direct"`
77717715 
7772
7716 - `"code_execution_20250825"`
7717 
7718 - `"code_execution_20260120"`
7719 
7720 - `"code_execution_20260521"`
7721 
7722 - `allowed_domains: optional array of string or null`
7723 
7724 List of domains to allow fetching from
7725 
7726 - `blocked_domains: optional array of string or null`
7727 
7728 List of domains to block fetching from
7729 
7730 - `cache_control: optional BetaCacheControlEphemeral or null`
7731 
7732 Create a cache control breakpoint at this content block.
7733 
7734 - `citations: optional BetaCitationsConfigParam or null`
7735 
7736 Citations configuration for fetched documents. Citations are disabled by default.
7737 
7738 - `enabled: optional boolean`
7739 
7740 - `defer_loading: optional boolean`
7741 
7742 If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
7743 
7744 - `max_content_tokens: optional number or null`
7745 
7746 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.
7747 
7748 minimum: 1
7749 
7750 - `max_uses: optional number or null`
7751 
7752 Maximum number of times the tool can be used in the API request.
7753 
7754 minimum: 1
7755 
7756 - `strict: optional boolean`
7757 
7758 When true, guarantees schema validation on tool names and inputs
7759 
7760 - `url_sources: optional BetaWebFetchURLSources or null`
7761 
7762 Which sources contribute to the set of URLs the tool may fetch. Omitted means every source.
7763 
7764 - `client_tool_results: optional BetaWebFetchURLSourceAll or BetaWebFetchURLSourceNone or BetaWebFetchURLSourceOnly or BetaWebFetchURLSourceExcept`
7765 
7766 Which client tools' results contribute fetchable URLs: "all"
Feedback