Messages changedapi/beta/messages
Nearest release: v2.1.247, published under 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+206added
Lines−44removed
From line
18
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits29to this page, all time
The whole hunk
from line 18, old and new numbered
/
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 18
1818
1919 - `string`
2020
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2222
2323 - `"message-batches-2024-09-24"`
2424
from line 88
8888
8989 - `"mid-conversation-tool-changes-2026-07-01"`
9090
91 - `"compact-2026-01-12"`
92
93 - `"computer-use-2025-11-24"`
94
95 - `"mcp-tunnels-2026-06-22"`
96
97 - `"structured-outputs-2025-11-13"`
98
99 - `"task-budgets-2026-03-13"`
100
101 - `"thinking-display-updates-2026-08-18"`
102
103 - `"ce-user-management-2026-07-13"`
104
91105- `"anthropic-user-profile-id": optional string`
92106
93107 The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header.
from line 1782
17681782
17691783 - `type: "enabled"`
17701784
1771 - `display: optional "summarized" or "omitted" or null`
1785 - `display: optional "summarized" or "omitted" or "updates" or null`
17721786
17731787 Controls how thinking content appears in the response. When set to `summarized`, thinking is returned normally. When set to `omitted`, thinking content is redacted but a signature is returned for multi-turn continuity. Defaults to `summarized`.
17741788
from line 1790
17761790
17771791 - `"omitted"`
17781792
1793 - `"updates"`
1794
17791795 - `BetaThinkingConfigDisabled object`
17801796
17811797 - `type: "disabled"`
from line 1800
17841800
17851801 - `type: "adaptive"`
17861802
1787 - `display: optional "summarized" or "omitted" or null`
1803 - `display: optional "summarized" or "omitted" or "updates" or null`
17881804
17891805 Controls how thinking content appears in the response. When set to `summarized`, thinking is returned normally. When set to `omitted`, thinking content is redacted but a signature is returned for multi-turn continuity. Defaults to `summarized`.
17901806
from line 1808
17921808
17931809 - `"omitted"`
17941810
1811 - `"updates"`
1812
17951813 - `Default = "default"`
17961814
17971815- `inference_geo: optional string or null`
from line 5320
53025320
53035321 Per-iteration token usage breakdown.
53045322
5305 Each entry represents one sampling iteration, with its own input/output token counts and cache statistics. This allows you to:
5323 Each entry represents one sampling iteration, with its own input/output token counts and cache statistics, discriminated by `type`. For `message` entries (model sampling iterations, such as the turns of a server-side tool use loop), this allows you to:
53065324
53075325 - Determine which iterations exceeded long context thresholds (>=200k tokens)
5308 - Calculate the true context window size from the last iteration
5326 - Calculate the context window size from the last `message` entry
53095327 - Understand token accumulation across server-side tool use loops
53105328
5329 A `compaction` entry reports the token usage of the compaction operation itself — the server-side request that summarizes the context being closed — NOT the size of the context that was compacted away, and its token counts can be much smaller than that closed context (for example, a compaction that closes a ~200k-token context can report only a few thousand tokens). Do not derive the context window size from a `compaction` entry, even when it is the last entry. A `compaction` entry's tokens are not included in the top-level `usage` fields. When an input-token trigger is in effect (the default — 150,000 tokens unless configured otherwise), each `compaction` entry closes a context that had reached at least that threshold, though the context can exceed it by the final iteration's output and tool results.
5330
53115331 - `BetaMessageIterationUsage object`
53125332
53135333 Token usage for a sampling iteration.
from line 5637
56175637
56185638 Per-iteration token usage breakdown.
56195639
5620 Each entry represents one sampling iteration, with its own input/output token counts and cache statistics. This allows you to:
5640 Each entry represents one sampling iteration, with its own input/output token counts and cache statistics, discriminated by `type`. For `message` entries (model sampling iterations, such as the turns of a server-side tool use loop), this allows you to:
56215641
56225642 - Determine which iterations exceeded long context thresholds (>=200k tokens)
5623 - Calculate the true context window size from the last iteration
5643 - Calculate the context window size from the last `message` entry
56245644 - Understand token accumulation across server-side tool use loops
56255645
5646 A `compaction` entry reports the token usage of the compaction operation itself — the server-side request that summarizes the context being closed — NOT the size of the context that was compacted away, and its token counts can be much smaller than that closed context (for example, a compaction that closes a ~200k-token context can report only a few thousand tokens). Do not derive the context window size from a `compaction` entry, even when it is the last entry. A `compaction` entry's tokens are not included in the top-level `usage` fields. When an input-token trigger is in effect (the default — 150,000 tokens unless configured otherwise), each `compaction` entry closes a context that had reached at least that threshold, though the context can exceed it by the final iteration's output and tool results.
5647
56265648 - `output_tokens: number`
56275649
56285650 The cumulative number of output tokens which were used.
from line 5991
59695991
59705992 - `string`
59715993
5972 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
5994 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
59735995
59745996 - `"message-batches-2024-09-24"`
59755997
from line 6061
60396061
60406062 - `"mid-conversation-tool-changes-2026-07-01"`
60416063
6064 - `"compact-2026-01-12"`
6065
6066 - `"computer-use-2025-11-24"`
6067
6068 - `"mcp-tunnels-2026-06-22"`
6069
6070 - `"structured-outputs-2025-11-13"`
6071
6072 - `"task-budgets-2026-03-13"`
6073
6074 - `"thinking-display-updates-2026-08-18"`
6075
6076 - `"ce-user-management-2026-07-13"`
6077
60426078- `"anthropic-user-profile-id": optional string`
60436079
60446080 The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header.
from line 7679
76437679
76447680 - `type: "enabled"`
76457681
7646 - `display: optional "summarized" or "omitted" or null`
7682 - `display: optional "summarized" or "omitted" or "updates" or null`
76477683
76487684 Controls how thinking content appears in the response. When set to `summarized`, thinking is returned normally. When set to `omitted`, thinking content is redacted but a signature is returned for multi-turn continuity. Defaults to `summarized`.
76497685
from line 7687
76517687
76527688 - `"omitted"`
76537689
7690 - `"updates"`
7691
76547692 - `BetaThinkingConfigDisabled object`
76557693
76567694 - `type: "disabled"`
from line 7697
76597697
76607698 - `type: "adaptive"`
76617699
7662 - `display: optional "summarized" or "omitted" or null`
7700 - `display: optional "summarized" or "omitted" or "updates" or null`
76637701
76647702 Controls how thinking content appears in the response. When set to `summarized`, thinking is returned normally. When set to `omitted`, thinking content is redacted but a signature is returned for multi-turn continuity. Defaults to `summarized`.
76657703
from line 7705
76677705
76687706 - `"omitted"`
76697707
7708 - `"updates"`
7709
76707710- `tool_choice: optional BetaToolChoice`
76717711
76727712 How the model should use the provided tools. The model can use a specific tool, any available tool, decide by itself, or not use tools at all.
from line 8385
83458385
83468386 - `enabled: optional boolean or null`
83478387
8348 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.
8349
8350 - `screenshot: optional BetaBrowserScreenshotConfig or null`
8351
8352 `screenshot`'s config overrides.
8353
8354 - `defer_loading: optional boolean or null`
8355
8356 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
8357
8358 - `enabled: optional boolean or null`
8359
8360 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.
8361
8362 - `scroll: optional BetaBrowserScrollConfig or null`
8363
8364 `scroll`'s config overrides.
8365
8366 - `defer_loading: optional boolean or null`
8367
8368 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
8369
8370 - `enabled: optional boolean or null`
8371
8372 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.
8373
8374 - `scroll_to: optional BetaBrowserScrollToConfig or null`
8375
8376 `scroll_to`'s config overrides.
8377
8378 - `defer_loading: optional boolean or null`
8379
8380 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
8381
8382 - `enabled: optional boolean or null`
8383
8384 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.
8385
8386 - `switch_tab: optional BetaBrowserSwitchTabConfig or null`
8387
8388 `switch_tab`'s config overrides.
8389
8390 - `defer_loading: optional boolean or null`
8391
8392 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
8393
8394 - `enabled: optional boolean or null`
8395
8396 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.
8397
8398 - `triple_click: optional BetaBrowserTripleClickConfig or null`
8399
8400 `triple_click`'s config overrides.
8401
8402 - `defer_loading: optional boolean or null`
8403
8404 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
8405
8406 - `enabled: optional boolean or null`
8407
8408 Whether this member is offered to the model. Default is per member, per the toolset's documentation. A member whose enab
8388 Whether this member is offered to the model. Default is per member, per the
No line in this hunk matches that.