One read of Claude Developer Platformapi-20260826T180819Z
239 pages moved out of 688 read.
Pages moved
239
significant first
Pages read
688
in this capture
Captured
18:08 UTC
Corpus hash
c1a577247bc1
corpus-hash
What this read moved
51-75 of 239, page 3 of 10This capture is too large to show at once. Changes 51-75 of 239 are below, significant first; the rest are on the following screens.
api/beta/memory_stores/archive Changed · +15 / -1 lines
from line 16
1616
1717 - `string`
1818
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2020
2121 - `"message-batches-2024-09-24"`
2222
from line 85
8585 - `"agent-memory-2026-07-22"`
8686
8787 - `"mid-conversation-tool-changes-2026-07-01"`
88
89 - `"compact-2026-01-12"`
90
91 - `"computer-use-2025-11-24"`
92
93 - `"mcp-tunnels-2026-06-22"`
94
95 - `"structured-outputs-2025-11-13"`
96
97 - `"task-budgets-2026-03-13"`
98
99 - `"thinking-display-updates-2026-08-18"`
100
101 - `"ce-user-management-2026-07-13"`
88102
89103## Returns
90104
api/beta/memory_stores/create Changed · +15 / -1 lines
from line 12
1212
1313 - `string`
1414
15 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
15 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
1616
1717 - `"message-batches-2024-09-24"`
1818
from line 81
8181 - `"agent-memory-2026-07-22"`
8282
8383 - `"mid-conversation-tool-changes-2026-07-01"`
84
85 - `"compact-2026-01-12"`
86
87 - `"computer-use-2025-11-24"`
88
89 - `"mcp-tunnels-2026-06-22"`
90
91 - `"structured-outputs-2025-11-13"`
92
93 - `"task-budgets-2026-03-13"`
94
95 - `"thinking-display-updates-2026-08-18"`
96
97 - `"ce-user-management-2026-07-13"`
8498
8599## Body parameters
86100
api/beta/memory_stores/delete Changed · +15 / -1 lines
from line 16
1616
1717 - `string`
1818
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2020
2121 - `"message-batches-2024-09-24"`
2222
from line 85
8585 - `"agent-memory-2026-07-22"`
8686
8787 - `"mid-conversation-tool-changes-2026-07-01"`
88
89 - `"compact-2026-01-12"`
90
91 - `"computer-use-2025-11-24"`
92
93 - `"mcp-tunnels-2026-06-22"`
94
95 - `"structured-outputs-2025-11-13"`
96
97 - `"task-budgets-2026-03-13"`
98
99 - `"thinking-display-updates-2026-08-18"`
100
101 - `"ce-user-management-2026-07-13"`
88102
89103## Returns
90104
api/beta/memory_stores/list Changed · +15 / -1 lines
from line 40
4040
4141 - `string`
4242
43 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
43 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
4444
4545 - `"message-batches-2024-09-24"`
4646
from line 109
109109 - `"agent-memory-2026-07-22"`
110110
111111 - `"mid-conversation-tool-changes-2026-07-01"`
112
113 - `"compact-2026-01-12"`
114
115 - `"computer-use-2025-11-24"`
116
117 - `"mcp-tunnels-2026-06-22"`
118
119 - `"structured-outputs-2025-11-13"`
120
121 - `"task-budgets-2026-03-13"`
122
123 - `"thinking-display-updates-2026-08-18"`
124
125 - `"ce-user-management-2026-07-13"`
112126
113127## Returns
114128
api/beta/memory_stores/memories Changed · +83 / -13 lines
from line 28
2828
2929 - `string`
3030
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
3232
3333 - `"message-batches-2024-09-24"`
3434
from line 98
9898
9999 - `"mid-conversation-tool-changes-2026-07-01"`
100100
101 - `"compact-2026-01-12"`
102
103 - `"computer-use-2025-11-24"`
104
105 - `"mcp-tunnels-2026-06-22"`
106
107 - `"structured-outputs-2025-11-13"`
108
109 - `"task-budgets-2026-03-13"`
110
111 - `"thinking-display-updates-2026-08-18"`
112
113 - `"ce-user-management-2026-07-13"`
114
101115### Body parameters
102116
103117- `content: string or null`
from line 156
142156
143157 - `memory_version_id: string`
144158
145 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
159 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
146160
147161 - `path: string`
148162
from line 253
239253
240254 - `string`
241255
242 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
256 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
243257
244258 - `"message-batches-2024-09-24"`
245259
from line 323
309323
310324 - `"mid-conversation-tool-changes-2026-07-01"`
311325
326 - `"compact-2026-01-12"`
327
328 - `"computer-use-2025-11-24"`
329
330 - `"mcp-tunnels-2026-06-22"`
331
332 - `"structured-outputs-2025-11-13"`
333
334 - `"task-budgets-2026-03-13"`
335
336 - `"thinking-display-updates-2026-08-18"`
337
338 - `"ce-user-management-2026-07-13"`
339
312340### Returns
313341
314342- `data: optional array of BetaManagedAgentsMemoryListItem`
from line 373
345373
346374 - `memory_version_id: string`
347375
348 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
376 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
349377
350378 - `path: string`
351379
from line 466
438466
439467 - `string`
440468
441 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
469 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
442470
443471 - `"message-batches-2024-09-24"`
444472
from line 536
508536
509537 - `"mid-conversation-tool-changes-2026-07-01"`
510538
539 - `"compact-2026-01-12"`
540
541 - `"computer-use-2025-11-24"`
542
543 - `"mcp-tunnels-2026-06-22"`
544
545 - `"structured-outputs-2025-11-13"`
546
547 - `"task-budgets-2026-03-13"`
548
549 - `"thinking-display-updates-2026-08-18"`
550
551 - `"ce-user-management-2026-07-13"`
552
511553### Returns
512554
513555- `BetaManagedAgentsMemory object`
from line 582
540582
541583 - `memory_version_id: string`
542584
543 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
585 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
544586
545587 - `path: string`
546588
from line 656
614656
615657 - `string`
616658
617 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
659 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
618660
619661 - `"message-batches-2024-09-24"`
620662
from line 726
684726
685727 - `"mid-conversation-tool-changes-2026-07-01"`
686728
729 - `"compact-2026-01-12"`
730
731 - `"computer-use-2025-11-24"`
732
733 - `"mcp-tunnels-2026-06-22"`
734
735 - `"structured-outputs-2025-11-13"`
736
737 - `"task-budgets-2026-03-13"`
738
739 - `"thinking-display-updates-2026-08-18"`
740
741 - `"ce-user-management-2026-07-13"`
742
687743### Body parameters
688744
689745- `content: optional string or null`
from line 794
738794
739795 - `memory_version_id: string`
740796
741 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
797 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
742798
743799 - `path: string`
744800
from line 866
810866
811867 - `string`
812868
813 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
869 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
814870
815871 - `"message-batches-2024-09-24"`
816872
from line 936
880936
881937 - `"mid-conversation-tool-changes-2026-07-01"`
882938
939 - `"compact-2026-01-12"`
940
941 - `"computer-use-2025-11-24"`
942
943 - `"mcp-tunnels-2026-06-22"`
944
945 - `"structured-outputs-2025-11-13"`
946
947 - `"task-budgets-2026-03-13"`
948
949 - `"thinking-display-updates-2026-08-18"`
950
951 - `"ce-user-management-2026-07-13"`
952
883953### Returns
884954
885955- `BetaManagedAgentsDeletedMemory object`
886956
887 Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). The memory's version history persists and remains listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) until the store itself is deleted.
957 Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). Deleting a memory does not erase its version history: its versions remain listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) while they are retained (each version is kept for at least the version retention period after it was written, unless the store itself is deleted).
888958
889959 - `id: string`
890960
from line 1007
9371007
9381008- `BetaManagedAgentsDeletedMemory object`
9391009
940 Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). The memory's version history persists and remains listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) until the store itself is deleted.
1010 Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). Deleting a memory does not erase its version history: its versions remain listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) while they are retained (each version is kept for at least the version retention period after it was written, unless the store itself is deleted).
9411011
9421012 - `id: string`
9431013
from line 1163
10931163
10941164 - `memory_version_id: string`
10951165
1096 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
1166 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
10971167
10981168 - `path: string`
10991169
from line 1217
11471217
11481218 - `memory_version_id: string`
11491219
1150 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
1220 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
11511221
11521222 - `path: string`
11531223
api/beta/memory_stores/memories/create Changed · +16 / -2 lines
from line 26
2626
2727 - `string`
2828
29 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
29 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
3030
3131 - `"message-batches-2024-09-24"`
3232
from line 96
9696
9797 - `"mid-conversation-tool-changes-2026-07-01"`
9898
99 - `"compact-2026-01-12"`
100
101 - `"computer-use-2025-11-24"`
102
103 - `"mcp-tunnels-2026-06-22"`
104
105 - `"structured-outputs-2025-11-13"`
106
107 - `"task-budgets-2026-03-13"`
108
109 - `"thinking-display-updates-2026-08-18"`
110
111 - `"ce-user-management-2026-07-13"`
112
99113## Body parameters
100114
101115- `content: string or null`
from line 154
140154
141155 - `memory_version_id: string`
142156
143 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
157 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
144158
145159 - `path: string`
146160
api/beta/memory_stores/memories/delete Changed · +16 / -2 lines
from line 24
2424
2525 - `string`
2626
27 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
27 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2828
2929 - `"message-batches-2024-09-24"`
3030
from line 94
9494
9595 - `"mid-conversation-tool-changes-2026-07-01"`
9696
97 - `"compact-2026-01-12"`
98
99 - `"computer-use-2025-11-24"`
100
101 - `"mcp-tunnels-2026-06-22"`
102
103 - `"structured-outputs-2025-11-13"`
104
105 - `"task-budgets-2026-03-13"`
106
107 - `"thinking-display-updates-2026-08-18"`
108
109 - `"ce-user-management-2026-07-13"`
110
97111## Returns
98112
99113- `BetaManagedAgentsDeletedMemory object`
100114
101 Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). The memory's version history persists and remains listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) until the store itself is deleted.
115 Tombstone returned by [Delete a memory](/docs/en/api/beta/memory_stores/memories/delete). Deleting a memory does not erase its version history: its versions remain listable via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) while they are retained (each version is kept for at least the version retention period after it was written, unless the store itself is deleted).
102116
103117 - `id: string`
104118
api/beta/memory_stores/memories/list Changed · +16 / -2 lines
from line 46
4646
4747 - `string`
4848
49 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
49 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
5050
5151 - `"message-batches-2024-09-24"`
5252
from line 116
116116
117117 - `"mid-conversation-tool-changes-2026-07-01"`
118118
119 - `"compact-2026-01-12"`
120
121 - `"computer-use-2025-11-24"`
122
123 - `"mcp-tunnels-2026-06-22"`
124
125 - `"structured-outputs-2025-11-13"`
126
127 - `"task-budgets-2026-03-13"`
128
129 - `"thinking-display-updates-2026-08-18"`
130
131 - `"ce-user-management-2026-07-13"`
132
119133## Returns
120134
121135- `data: optional array of BetaManagedAgentsMemoryListItem`
from line 166
152166
153167 - `memory_version_id: string`
154168
155 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
169 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
156170
157171 - `path: string`
158172
api/beta/memory_stores/memories/retrieve Changed · +16 / -2 lines
from line 28
2828
2929 - `string`
3030
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
3232
3333 - `"message-batches-2024-09-24"`
3434
from line 98
9898
9999 - `"mid-conversation-tool-changes-2026-07-01"`
100100
101 - `"compact-2026-01-12"`
102
103 - `"computer-use-2025-11-24"`
104
105 - `"mcp-tunnels-2026-06-22"`
106
107 - `"structured-outputs-2025-11-13"`
108
109 - `"task-budgets-2026-03-13"`
110
111 - `"thinking-display-updates-2026-08-18"`
112
113 - `"ce-user-management-2026-07-13"`
114
101115## Returns
102116
103117- `BetaManagedAgentsMemory object`
from line 144
130144
131145 - `memory_version_id: string`
132146
133 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
147 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
134148
135149 - `path: string`
136150
api/beta/memory_stores/memories/update Changed · +16 / -2 lines
from line 28
2828
2929 - `string`
3030
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
3232
3333 - `"message-batches-2024-09-24"`
3434
from line 98
9898
9999 - `"mid-conversation-tool-changes-2026-07-01"`
100100
101 - `"compact-2026-01-12"`
102
103 - `"computer-use-2025-11-24"`
104
105 - `"mcp-tunnels-2026-06-22"`
106
107 - `"structured-outputs-2025-11-13"`
108
109 - `"task-budgets-2026-03-13"`
110
111 - `"thinking-display-updates-2026-08-18"`
112
113 - `"ce-user-management-2026-07-13"`
114
101115## Body parameters
102116
103117- `content: optional string or null`
from line 166
152166
153167 - `memory_version_id: string`
154168
155 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the full history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
169 ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list).
156170
157171 - `path: string`
158172
api/beta/memory_stores/memory_versions Changed · +52 / -10 lines
from line 76
7676
7777 - `string`
7878
79 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
79 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
8080
8181 - `"message-batches-2024-09-24"`
8282
from line 146
146146
147147 - `"mid-conversation-tool-changes-2026-07-01"`
148148
149 - `"compact-2026-01-12"`
150
151 - `"computer-use-2025-11-24"`
152
153 - `"mcp-tunnels-2026-06-22"`
154
155 - `"structured-outputs-2025-11-13"`
156
157 - `"task-budgets-2026-03-13"`
158
159 - `"thinking-display-updates-2026-08-18"`
160
161 - `"ce-user-management-2026-07-13"`
162
149163### Returns
150164
151165- `data: optional array of BetaManagedAgentsMemoryVersion`
from line 178
164178
165179 - `memory_id: string`
166180
167 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
181 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the memory's retained versions, including the `deleted` row while the lineage is retained.
168182
169183 - `memory_store_id: string`
170184
from line 350
336350
337351 - `string`
338352
339 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
353 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
340354
341355 - `"message-batches-2024-09-24"`
342356
from line 420
406420
407421 - `"mid-conversation-tool-changes-2026-07-01"`
408422
423 - `"compact-2026-01-12"`
424
425 - `"computer-use-2025-11-24"`
426
427 - `"mcp-tunnels-2026-06-22"`
428
429 - `"structured-outputs-2025-11-13"`
430
431 - `"task-budgets-2026-03-13"`
432
433 - `"thinking-display-updates-2026-08-18"`
434
435 - `"ce-user-management-2026-07-13"`
436
409437### Returns
410438
411439- `BetaManagedAgentsMemoryVersion object`
412440
413 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
441 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and are not deleted with the memory; each version is retained for at least the version retention period after it was written, unless the store itself is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
414442
415443 - `id: string`
416444
from line 452
424452
425453 - `memory_id: string`
426454
427 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
455 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the memory's retained versions, including the `deleted` row while the lineage is retained.
428456
429457 - `memory_store_id: string`
430458
from line 605
577605
578606 - `string`
579607
580 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
608 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
581609
582610 - `"message-batches-2024-09-24"`
583611
from line 675
647675
648676 - `"mid-conversation-tool-changes-2026-07-01"`
649677
678 - `"compact-2026-01-12"`
679
680 - `"computer-use-2025-11-24"`
681
682 - `"mcp-tunnels-2026-06-22"`
683
684 - `"structured-outputs-2025-11-13"`
685
686 - `"task-budgets-2026-03-13"`
687
688 - `"thinking-display-updates-2026-08-18"`
689
690 - `"ce-user-management-2026-07-13"`
691
650692### Returns
651693
652694- `BetaManagedAgentsMemoryVersion object`
653695
654 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
696 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and are not deleted with the memory; each version is retained for at least the version retention period after it was written, unless the store itself is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
655697
656698 - `id: string`
657699
from line 707
665707
666708 - `memory_id: string`
667709
668 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
710 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the memory's retained versions, including the `deleted` row while the lineage is retained.
669711
670712 - `memory_store_id: string`
671713
from line 915
873915
874916- `BetaManagedAgentsMemoryVersion object`
875917
876 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
918 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and are not deleted with the memory; each version is retained for at least the version retention period after it was written, unless the store itself is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
877919
878920 - `id: string`
879921
from line 929
887929
888930 - `memory_id: string`
889931
890 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
932 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the memory's retained versions, including the `deleted` row while the lineage is retained.
891933
892934 - `memory_store_id: string`
893935
api/beta/memory_stores/memory_versions/list Changed · +16 / -2 lines
from line 74
7474
7575 - `string`
7676
77 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
77 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
7878
7979 - `"message-batches-2024-09-24"`
8080
from line 144
144144
145145 - `"mid-conversation-tool-changes-2026-07-01"`
146146
147 - `"compact-2026-01-12"`
148
149 - `"computer-use-2025-11-24"`
150
151 - `"mcp-tunnels-2026-06-22"`
152
153 - `"structured-outputs-2025-11-13"`
154
155 - `"task-budgets-2026-03-13"`
156
157 - `"thinking-display-updates-2026-08-18"`
158
159 - `"ce-user-management-2026-07-13"`
160
147161## Returns
148162
149163- `data: optional array of BetaManagedAgentsMemoryVersion`
from line 176
162176
163177 - `memory_id: string`
164178
165 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
179 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the memory's retained versions, including the `deleted` row while the lineage is retained.
166180
167181 - `memory_store_id: string`
168182
api/beta/memory_stores/memory_versions/redact Changed · +17 / -3 lines
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## Returns
92106
93107- `BetaManagedAgentsMemoryVersion object`
94108
95 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
109 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and are not deleted with the memory; each version is retained for at least the version retention period after it was written, unless the store itself is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
96110
97111 - `id: string`
98112
from line 120
106120
107121 - `memory_id: string`
108122
109 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
123 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the memory's retained versions, including the `deleted` row while the lineage is retained.
110124
111125 - `memory_store_id: string`
112126
api/beta/memory_stores/memory_versions/retrieve Changed · +17 / -3 lines
from line 28
2828
2929 - `string`
3030
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
3232
3333 - `"message-batches-2024-09-24"`
3434
from line 98
9898
9999 - `"mid-conversation-tool-changes-2026-07-01"`
100100
101 - `"compact-2026-01-12"`
102
103 - `"computer-use-2025-11-24"`
104
105 - `"mcp-tunnels-2026-06-22"`
106
107 - `"structured-outputs-2025-11-13"`
108
109 - `"task-budgets-2026-03-13"`
110
111 - `"thinking-display-updates-2026-08-18"`
112
113 - `"ce-user-management-2026-07-13"`
114
101115## Returns
102116
103117- `BetaManagedAgentsMemoryVersion object`
104118
105 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
119 A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and are not deleted with the memory; each version is retained for at least the version retention period after it was written, unless the store itself is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
106120
107121 - `id: string`
108122
from line 130
116130
117131 - `memory_id: string`
118132
119 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
133 ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the memory's retained versions, including the `deleted` row while the lineage is retained.
120134
121135 - `memory_store_id: string`
122136
api/beta/memory_stores/retrieve Changed · +15 / -1 lines
from line 16
1616
1717 - `string`
1818
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2020
2121 - `"message-batches-2024-09-24"`
2222
from line 85
8585 - `"agent-memory-2026-07-22"`
8686
8787 - `"mid-conversation-tool-changes-2026-07-01"`
88
89 - `"compact-2026-01-12"`
90
91 - `"computer-use-2025-11-24"`
92
93 - `"mcp-tunnels-2026-06-22"`
94
95 - `"structured-outputs-2025-11-13"`
96
97 - `"task-budgets-2026-03-13"`
98
99 - `"thinking-display-updates-2026-08-18"`
100
101 - `"ce-user-management-2026-07-13"`
88102
89103## Returns
90104
api/beta/memory_stores/update Changed · +15 / -1 lines
from line 16
1616
1717 - `string`
1818
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2020
2121 - `"message-batches-2024-09-24"`
2222
from line 85
8585 - `"agent-memory-2026-07-22"`
8686
8787 - `"mid-conversation-tool-changes-2026-07-01"`
88
89 - `"compact-2026-01-12"`
90
91 - `"computer-use-2025-11-24"`
92
93 - `"mcp-tunnels-2026-06-22"`
94
95 - `"structured-outputs-2025-11-13"`
96
97 - `"task-budgets-2026-03-13"`
98
99 - `"thinking-display-updates-2026-08-18"`
100
101 - `"ce-user-management-2026-07-13"`
88102
89103## Body parameters
90104
api/beta/messages Changed · +206 / -44 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 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
api/beta/messages/batches Changed · +112 / -16 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 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 the requests in this batch to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header. Applies to every request in the batch; an individual request whose `user_profile_id` body field conflicts with this header is errored.
from line 1802
17881802
17891803 - `type: "enabled"`
17901804
1791 - `display: optional "summarized" or "omitted" or null`
1805 - `display: optional "summarized" or "omitted" or "updates" or null`
17921806
17931807 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`.
17941808
from line 1810
17961810
17971811 - `"omitted"`
17981812
1813 - `"updates"`
1814
17991815 - `BetaThinkingConfigDisabled object`
18001816
18011817 - `type: "disabled"`
from line 1820
18041820
18051821 - `type: "adaptive"`
18061822
1807 - `display: optional "summarized" or "omitted" or null`
1823 - `display: optional "summarized" or "omitted" or "updates" or null`
18081824
18091825 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`.
18101826
from line 1828
18121828
18131829 - `"omitted"`
18141830
1831 - `"updates"`
1832
18151833 - `Default = "default"`
18161834
18171835 - `inference_geo: optional string or null`
from line 4105
40874105
40884106 - `string`
40894107
4090 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
4108 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
40914109
40924110 - `"message-batches-2024-09-24"`
40934111
from line 4175
41574175
41584176 - `"mid-conversation-tool-changes-2026-07-01"`
41594177
4178 - `"compact-2026-01-12"`
4179
4180 - `"computer-use-2025-11-24"`
4181
4182 - `"mcp-tunnels-2026-06-22"`
4183
4184 - `"structured-outputs-2025-11-13"`
4185
4186 - `"task-budgets-2026-03-13"`
4187
4188 - `"thinking-display-updates-2026-08-18"`
4189
4190 - `"ce-user-management-2026-07-13"`
4191
41604192### Returns
41614193
41624194- `BetaMessageBatch object`
from line 4365
43334365
43344366 - `string`
43354367
4336 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
4368 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
43374369
43384370 - `"message-batches-2024-09-24"`
43394371
from line 4435
44034435
44044436 - `"mid-conversation-tool-changes-2026-07-01"`
44054437
4438 - `"compact-2026-01-12"`
4439
4440 - `"computer-use-2025-11-24"`
4441
4442 - `"mcp-tunnels-2026-06-22"`
4443
4444 - `"structured-outputs-2025-11-13"`
4445
4446 - `"task-budgets-2026-03-13"`
4447
4448 - `"thinking-display-updates-2026-08-18"`
4449
4450 - `"ce-user-management-2026-07-13"`
4451
44064452### Returns
44074453
44084454- `data: array of BetaMessageBatch`
from line 4634
45884634
45894635 - `string`
45904636
4591 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
4637 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
45924638
45934639 - `"message-batches-2024-09-24"`
45944640
from line 4704
46584704
46594705 - `"mid-conversation-tool-changes-2026-07-01"`
46604706
4707 - `"compact-2026-01-12"`
4708
4709 - `"computer-use-2025-11-24"`
4710
4711 - `"mcp-tunnels-2026-06-22"`
4712
4713 - `"structured-outputs-2025-11-13"`
4714
4715 - `"task-budgets-2026-03-13"`
4716
4717 - `"thinking-display-updates-2026-08-18"`
4718
4719 - `"ce-user-management-2026-07-13"`
4720
46614721### Returns
46624722
46634723- `BetaMessageBatch object`
from line 4885
48254885
48264886 - `string`
48274887
4828 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
4888 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
48294889
48304890 - `"message-batches-2024-09-24"`
48314891
from line 4955
48954955
48964956 - `"mid-conversation-tool-changes-2026-07-01"`
48974957
4958 - `"compact-2026-01-12"`
4959
4960 - `"computer-use-2025-11-24"`
4961
4962 - `"mcp-tunnels-2026-06-22"`
4963
4964 - `"structured-outputs-2025-11-13"`
4965
4966 - `"task-budgets-2026-03-13"`
4967
4968 - `"thinking-display-updates-2026-08-18"`
4969
4970 - `"ce-user-management-2026-07-13"`
4971
48984972### Returns
48994973
49004974- `BetaDeletedMessageBatch object`
from line 5028
49545028
49555029 - `string`
49565030
4957 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
5031 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
49585032
49595033 - `"message-batches-2024-09-24"`
49605034
from line 5098
50245098
50255099 - `"mid-conversation-tool-changes-2026-07-01"`
50265100
5101 - `"compact-2026-01-12"`
5102
5103 - `"computer-use-2025-11-24"`
5104
5105 - `"mcp-tunnels-2026-06-22"`
5106
5107 - `"structured-outputs-2025-11-13"`
5108
5109 - `"task-budgets-2026-03-13"`
5110
5111 - `"thinking-display-updates-2026-08-18"`
5112
5113 - `"ce-user-management-2026-07-13"`
5114
50275115### Returns
50285116
50295117- `BetaMessageBatchIndividualResponse object`
from line 6547
64596547
64606548 Per-iteration token usage breakdown.
64616549
6462 Each entry represents one sampling iteration, with its own input/output token counts and cache statistics. This allows you to:
6550 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:
64636551
64646552 - Determine which iterations exceeded long context thresholds (>=200k tokens)
6465 - Calculate the true context window size from the last iteration
6553 - Calculate the context window size from the last `message` entry
64666554 - Understand token accumulation across server-side tool use loops
64676555
6556 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.
6557
64686558 - `BetaMessageIterationUsage object`
64696559
64706560 Token usage for a sampling iteration.
from line 8375
82858375
82868376 The request asks the model to reproduce its internal reasoning in the response text. To get reasoning in a structured form instead, use [adaptive thinking](https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking).
82878377
8288 - `"general_harms"`
8289
8290 The request could be related to an area that was determined as harmful. Benign work might sometimes trigger this category.
8291
8292 - `explanation: string or null`
8293
8294 Human-readable explanation of the refusal.
8295
8296 This text is not guaranteed to be stable. `null` when no explanation is available for the category.
8297
8298 - `fallback_credit_token: string or null`
8299
8300 Opaque code that refunds the cache-miss cost when retrying this refused
8301 request on the fallback model. Pass it as `fallback_credit_token` on the
8302 retry request. Expires 5 minutes after the refusal.
8303
8304 The retry is sent either with the same request body (`system`, `messages`,
8305 `tools`, and other render-shaping fields), or with the same body plus one
8306 appended `assistant` message whose content is the partial text (with any
8307 trailing whitespace stripped from the final text block) and paired
8308 server-tool blocks from this refusal — which also authorizes that
8309 appended turn as an assistant-prefill continuation on models that otherwise
8310 disallow prefill. A token minted mid-server-tool-loop whose partial content
8311 was continuable may only be redeemed the second way — if a same-body retry
8312 is rejected with a 400 saying the token must be redeemed by continuing the
8313 partial response, retry the second way instead. Either way: same workspace,
8314 same platform; a mismatch is a 400. Resending a token for an already-warm
8315 prefix is permitted but yields no additional credit.
8316
8317 `null` when the refused model isn't eligible for a fallback credit.
8318
8319 - `fallback_has_prefill_claim: boolean or null`
8320
8321 Whether the accompanying `fallback_credit_token` may be redeemed with the
8322 appended-assistant retry form. Only set when `fallback_credit_token` is
8323 present.
8324
8325 `true`: retry by resending the same request body plus one appended
8326 `assistant` message whose content is this response's `content` with any
8327 trailing whitespace stripped from the final text block and unpaired
8328 `tool_use` blocks omitted (the same appended-turn shape described on
8329 `fallback_credit_token`), with the token attached. `false`: retry by
8330 resending the original request body unchanged, with the token attached —
8331 the appended-assistant form is not available for this refusal (no
8332 continuable partial content, or the reques
8378 -
api/beta/messages/batches/cancel Changed · +15 / -1 lines
from line 22
2222
2323 - `string`
2424
25 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
25 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2626
2727 - `"message-batches-2024-09-24"`
2828
from line 91
9191 - `"agent-memory-2026-07-22"`
9292
9393 - `"mid-conversation-tool-changes-2026-07-01"`
94
95 - `"compact-2026-01-12"`
96
97 - `"computer-use-2025-11-24"`
98
99 - `"mcp-tunnels-2026-06-22"`
100
101 - `"structured-outputs-2025-11-13"`
102
103 - `"task-budgets-2026-03-13"`
104
105 - `"thinking-display-updates-2026-08-18"`
106
107 - `"ce-user-management-2026-07-13"`
94108
95109## Returns
96110
api/beta/messages/batches/create Changed · +21 / -3 lines
from line 16
1616
1717 - `string`
1818
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2020
2121 - `"message-batches-2024-09-24"`
2222
from line 86
8686
8787 - `"mid-conversation-tool-changes-2026-07-01"`
8888
89 - `"compact-2026-01-12"`
90
91 - `"computer-use-2025-11-24"`
92
93 - `"mcp-tunnels-2026-06-22"`
94
95 - `"structured-outputs-2025-11-13"`
96
97 - `"task-budgets-2026-03-13"`
98
99 - `"thinking-display-updates-2026-08-18"`
100
101 - `"ce-user-management-2026-07-13"`
102
89103- `"anthropic-user-profile-id": optional string`
90104
91105 The user profile ID to attribute the requests in this batch to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header. Applies to every request in the batch; an individual request whose `user_profile_id` body field conflicts with this header is errored.
from line 1800
17861800
17871801 - `type: "enabled"`
17881802
1789 - `display: optional "summarized" or "omitted" or null`
1803 - `display: optional "summarized" or "omitted" or "updates" or null`
17901804
17911805 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`.
17921806
from line 1808
17941808
17951809 - `"omitted"`
17961810
1811 - `"updates"`
1812
17971813 - `BetaThinkingConfigDisabled object`
17981814
17991815 - `type: "disabled"`
from line 1818
18021818
18031819 - `type: "adaptive"`
18041820
1805 - `display: optional "summarized" or "omitted" or null`
1821 - `display: optional "summarized" or "omitted" or "updates" or null`
18061822
18071823 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`.
18081824
from line 1825
18091825 - `"summarized"`
18101826
18111827 - `"omitted"`
1828
1829 - `"updates"`
18121830
18131831 - `Default = "default"`
18141832
api/beta/messages/batches/delete Changed · +15 / -1 lines
from line 22
2222
2323 - `string`
2424
25 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
25 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2626
2727 - `"message-batches-2024-09-24"`
2828
from line 91
9191 - `"agent-memory-2026-07-22"`
9292
9393 - `"mid-conversation-tool-changes-2026-07-01"`
94
95 - `"compact-2026-01-12"`
96
97 - `"computer-use-2025-11-24"`
98
99 - `"mcp-tunnels-2026-06-22"`
100
101 - `"structured-outputs-2025-11-13"`
102
103 - `"task-budgets-2026-03-13"`
104
105 - `"thinking-display-updates-2026-08-18"`
106
107 - `"ce-user-management-2026-07-13"`
94108
95109## Returns
96110
api/beta/messages/batches/list Changed · +15 / -1 lines
from line 32
3232
3333 - `string`
3434
35 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
35 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
3636
3737 - `"message-batches-2024-09-24"`
3838
from line 101
101101 - `"agent-memory-2026-07-22"`
102102
103103 - `"mid-conversation-tool-changes-2026-07-01"`
104
105 - `"compact-2026-01-12"`
106
107 - `"computer-use-2025-11-24"`
108
109 - `"mcp-tunnels-2026-06-22"`
110
111 - `"structured-outputs-2025-11-13"`
112
113 - `"task-budgets-2026-03-13"`
114
115 - `"thinking-display-updates-2026-08-18"`
116
117 - `"ce-user-management-2026-07-13"`
104118
105119## Returns
106120
api/beta/messages/batches/results Changed · +19 / -3 lines
from line 22
2222
2323 - `string`
2424
25 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
25 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2626
2727 - `"message-batches-2024-09-24"`
2828
from line 92
9292
9393 - `"mid-conversation-tool-changes-2026-07-01"`
9494
95 - `"compact-2026-01-12"`
96
97 - `"computer-use-2025-11-24"`
98
99 - `"mcp-tunnels-2026-06-22"`
100
101 - `"structured-outputs-2025-11-13"`
102
103 - `"task-budgets-2026-03-13"`
104
105 - `"thinking-display-updates-2026-08-18"`
106
107 - `"ce-user-management-2026-07-13"`
108
95109## Returns
96110
97111- `BetaMessageBatchIndividualResponse object`
from line 1541
15271541
15281542 Per-iteration token usage breakdown.
15291543
1530 Each entry represents one sampling iteration, with its own input/output token counts and cache statistics. This allows you to:
1544 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:
15311545
15321546 - Determine which iterations exceeded long context thresholds (>=200k tokens)
1533 - Calculate the true context window size from the last iteration
1547 - Calculate the context window size from the last `message` entry
15341548 - Understand token accumulation across server-side tool use loops
1549
1550 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.
15351551
15361552 - `BetaMessageIterationUsage object`
15371553
api/beta/messages/batches/retrieve Changed · +15 / -1 lines
from line 20
2020
2121 - `string`
2222
23 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
23 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2424
2525 - `"message-batches-2024-09-24"`
2626
from line 89
8989 - `"agent-memory-2026-07-22"`
9090
9191 - `"mid-conversation-tool-changes-2026-07-01"`
92
93 - `"compact-2026-01-12"`
94
95 - `"computer-use-2025-11-24"`
96
97 - `"mcp-tunnels-2026-06-22"`
98
99 - `"structured-outputs-2025-11-13"`
100
101 - `"task-budgets-2026-03-13"`
102
103 - `"thinking-display-updates-2026-08-18"`
104
105 - `"ce-user-management-2026-07-13"`
92106
93107## Returns
94108
api/beta/messages/count_tokens Changed · +21 / -3 lines
from line 16
1616
1717 - `string`
1818
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2020
2121 - `"message-batches-2024-09-24"`
2222
from line 86
8686
8787 - `"mid-conversation-tool-changes-2026-07-01"`
8888
89 - `"compact-2026-01-12"`
90
91 - `"computer-use-2025-11-24"`
92
93 - `"mcp-tunnels-2026-06-22"`
94
95 - `"structured-outputs-2025-11-13"`
96
97 - `"task-budgets-2026-03-13"`
98
99 - `"thinking-display-updates-2026-08-18"`
100
101 - `"ce-user-management-2026-07-13"`
102
89103- `"anthropic-user-profile-id": optional string`
90104
91105 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 1704
16901704
16911705 - `type: "enabled"`
16921706
1693 - `display: optional "summarized" or "omitted" or null`
1707 - `display: optional "summarized" or "omitted" or "updates" or null`
16941708
16951709 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`.
16961710
from line 1712
16981712
16991713 - `"omitted"`
17001714
1715 - `"updates"`
1716
17011717 - `BetaThinkingConfigDisabled object`
17021718
17031719 - `type: "disabled"`
from line 1722
17061722
17071723 - `type: "adaptive"`
17081724
1709 - `display: optional "summarized" or "omitted" or null`
1725 - `display: optional "summarized" or "omitted" or "updates" or null`
17101726
17111727 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`.
17121728
from line 1729
17131729 - `"summarized"`
17141730
17151731 - `"omitted"`
1732
1733 - `"updates"`
17161734
17171735- `tool_choice: optional BetaToolChoice`
17181736