Batches changedapi/messages/batches
Nearest release: v2.1.322, published 2 hours 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+184added
Lines−0removed
From line
1,125
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits28to this page, all time
The whole hunk
from line 1125, 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 1125
11251125
11261126 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
11271127
1128 - `"claude-fable-5-2"`
1129
1130 Built for the most ambitious work in coding, enterprise workflows, and the sciences
1131
1132 - `"claude-mythos-5-2"`
1133
1134 Built for the most demanding cybersecurity and life sciences research, available through verification programs
1135
11281136 - `"claude-haiku-5-5"`
11291137
11301138 Fastest model for high-volume, real-time tasks
from line 4804
47964804
47974805 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
47984806
4807 - `"claude-fable-5-2"`
4808
4809 Built for the most ambitious work in coding, enterprise workflows, and the sciences
4810
4811 - `"claude-mythos-5-2"`
4812
4813 Built for the most demanding cybersecurity and life sciences research, available through verification programs
4814
47994815 - `"claude-haiku-5-5"`
48004816
48014817 Fastest model for high-volume, real-time tasks
from line 5111
50955111
50965112 - `type: "invalid_request_error"`
50975113
5114 The broad category of the error.
5115
50985116 default: invalid_request_error
50995117
51005118 - `message: string`
51015119
5120 A human-readable explanation of the error. Its wording can change, so don't match on it.
5121
51025122 default: Invalid request
51035123
51045124 - `AuthenticationError object`
from line 5125
51055125
51065126 - `type: "authentication_error"`
51075127
5128 The broad category of the error.
5129
51085130 default: authentication_error
51095131
51105132 - `message: string`
51115133
5134 A human-readable explanation of the error. Its wording can change, so don't match on it.
5135
51125136 default: Authentication error
51135137
51145138 - `BillingError object`
from line 5139
51155139
51165140 - `type: "billing_error"`
51175141
5142 The broad category of the error.
5143
51185144 default: billing_error
51195145
51205146 - `message: string`
51215147
5148 A human-readable explanation of the error. Its wording can change, so don't match on it.
5149
51225150 default: Billing error
51235151
51245152 - `PermissionError object`
from line 5153
51255153
51265154 - `type: "permission_error"`
51275155
5156 The broad category of the error.
5157
51285158 default: permission_error
51295159
51305160 - `message: string`
51315161
5162 A human-readable explanation of the error. Its wording can change, so don't match on it.
5163
51325164 default: Permission denied
51335165
51345166 - `NotFoundError object`
from line 5167
51355167
51365168 - `type: "not_found_error"`
51375169
5170 The broad category of the error.
5171
51385172 default: not_found_error
51395173
51405174 - `message: string`
51415175
5176 A human-readable explanation of the error. Its wording can change, so don't match on it.
5177
51425178 default: Not found
51435179
51445180 - `RateLimitError object`
from line 5181
51455181
51465182 - `type: "rate_limit_error"`
51475183
5184 The broad category of the error.
5185
51485186 default: rate_limit_error
51495187
51505188 - `message: string`
51515189
5190 A human-readable explanation of the error. Its wording can change, so don't match on it.
5191
51525192 default: Rate limited
51535193
51545194 - `GatewayTimeoutError object`
from line 5195
51555195
51565196 - `type: "timeout_error"`
51575197
5198 The broad category of the error.
5199
51585200 default: timeout_error
51595201
51605202 - `message: string`
51615203
5204 A human-readable explanation of the error. Its wording can change, so don't match on it.
5205
51625206 default: Request timeout
51635207
51645208 - `APIErrorObject object`
from line 5209
51655209
51665210 - `type: "api_error"`
51675211
5212 The broad category of the error.
5213
51685214 default: api_error
51695215
51705216 - `message: string`
51715217
5218 A human-readable explanation of the error. Its wording can change, so don't match on it.
5219
51725220 default: Internal server error
51735221
51745222 - `OverloadedError object`
from line 5223
51755223
51765224 - `type: "overloaded_error"`
51775225
5226 The broad category of the error.
5227
51785228 default: overloaded_error
51795229
51805230 - `message: string`
51815231
5232 A human-readable explanation of the error. Its wording can change, so don't match on it.
5233
51825234 default: Overloaded
51835235
51845236 - `request_id: string or null`
from line 5411
53595411
53605412 - `type: "invalid_request_error"`
53615413
5414 The broad category of the error.
5415
53625416 default: invalid_request_error
53635417
53645418 - `message: string`
53655419
5420 A human-readable explanation of the error. Its wording can change, so don't match on it.
5421
53665422 default: Invalid request
53675423
53685424 - `AuthenticationError object`
from line 5425
53695425
53705426 - `type: "authentication_error"`
53715427
5428 The broad category of the error.
5429
53725430 default: authentication_error
53735431
53745432 - `message: string`
53755433
5434 A human-readable explanation of the error. Its wording can change, so don't match on it.
5435
53765436 default: Authentication error
53775437
53785438 - `BillingError object`
from line 5439
53795439
53805440 - `type: "billing_error"`
53815441
5442 The broad category of the error.
5443
53825444 default: billing_error
53835445
53845446 - `message: string`
53855447
5448 A human-readable explanation of the error. Its wording can change, so don't match on it.
5449
53865450 default: Billing error
53875451
53885452 - `PermissionError object`
from line 5453
53895453
53905454 - `type: "permission_error"`
53915455
5456 The broad category of the error.
5457
53925458 default: permission_error
53935459
53945460 - `message: string`
53955461
5462 A human-readable explanation of the error. Its wording can change, so don't match on it.
5463
53965464 default: Permission denied
53975465
53985466 - `NotFoundError object`
from line 5467
53995467
54005468 - `type: "not_found_error"`
54015469
5470 The broad category of the error.
5471
54025472 default: not_found_error
54035473
54045474 - `message: string`
54055475
5476 A human-readable explanation of the error. Its wording can change, so don't match on it.
5477
54065478 default: Not found
54075479
54085480 - `RateLimitError object`
from line 5481
54095481
54105482 - `type: "rate_limit_error"`
54115483
5484 The broad category of the error.
5485
54125486 default: rate_limit_error
54135487
54145488 - `message: string`
54155489
5490 A human-readable explanation of the error. Its wording can change, so don't match on it.
5491
54165492 default: Rate limited
54175493
54185494 - `GatewayTimeoutError object`
from line 5495
54195495
54205496 - `type: "timeout_error"`
54215497
5498 The broad category of the error.
5499
54225500 default: timeout_error
54235501
54245502 - `message: string`
54255503
5504 A human-readable explanation of the error. Its wording can change, so don't match on it.
5505
54265506 default: Request timeout
54275507
54285508 - `APIErrorObject object`
from line 5509
54295509
54305510 - `type: "api_error"`
54315511
5512 The broad category of the error.
5513
54325514 default: api_error
54335515
54345516 - `message: string`
54355517
5518 A human-readable explanation of the error. Its wording can change, so don't match on it.
5519
54365520 default: Internal server error
54375521
54385522 - `OverloadedError object`
from line 5523
54395523
54405524 - `type: "overloaded_error"`
54415525
5526 The broad category of the error.
5527
54425528 default: overloaded_error
54435529
54445530 - `message: string`
54455531
5532 A human-readable explanation of the error. Its wording can change, so don't match on it.
5533
54465534 default: Overloaded
54475535
54485536 - `request_id: string or null`
from line 6436
63486436
63496437 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
63506438
6439 - `"claude-fable-5-2"`
6440
6441 Built for the most ambitious work in coding, enterprise workflows, and the sciences
6442
6443 - `"claude-mythos-5-2"`
6444
6445 Built for the most demanding cybersecurity and life sciences research, available through verification programs
6446
63516447 - `"claude-haiku-5-5"`
63526448
63536449 Fastest model for high-volume, real-time tasks
from line 6743
66476743
66486744 - `type: "invalid_request_error"`
66496745
6746 The broad category of the error.
6747
66506748 default: invalid_request_error
66516749
66526750 - `message: string`
66536751
6752 A human-readable explanation of the error. Its wording can change, so don't match on it.
6753
66546754 default: Invalid request
66556755
66566756 - `AuthenticationError object`
from line 6757
66576757
66586758 - `type: "authentication_error"`
66596759
6760 The broad category of the error.
6761
66606762 default: authentication_error
66616763
66626764 - `message: string`
66636765
6766 A human-readable explanation of the error. Its wording can change, so don't match on it.
6767
66646768 default: Authentication error
66656769
66666770 - `BillingError object`
from line 6771
66676771
66686772 - `type: "billing_error"`
66696773
6774 The broad category of the error.
6775
66706776 default: billing_error
66716777
66726778 - `message: string`
66736779
6780 A human-readable explanation of the error. Its wording can change, so don't match on it.
6781
66746782 default: Billing error
66756783
66766784 - `PermissionError object`
from line 6785
66776785
66786786 - `type: "permission_error"`
66796787
6788 The broad category of the error.
6789
66806790 default: permission_error
66816791
66826792 - `message: string`
66836793
6794 A human-readable explanation of the error. Its wording can change, so don't match on it.
6795
66846796 default: Permission denied
66856797
66866798 - `NotFoundError object`
from line 6799
66876799
66886800 - `type: "not_found_error"`
66896801
6802 The broad category of the error.
6803
66906804 default: not_found_error
66916805
66926806 - `message: string`
66936807
6808 A human-readable explanation of the error. Its wording can change, so don't match on it.
6809
66946810 default: Not found
66956811
66966812 - `RateLimitError object`
from line 6813
66976813
66986814 - `type: "rate_limit_error"`
66996815
6816 The broad category of the error.
6817
67006818 default: rate_limit_error
67016819
67026820 - `message: string`
67036821
6822 A human-readable explanation of the error. Its wording can change, so don't match on it.
6823
67046824 default: Rate limited
67056825
67066826 - `GatewayTimeoutError object`
from line 6827
67076827
67086828 - `type: "timeout_error"`
67096829
6830 The broad category of the error.
6831
67106832 default: timeout_error
67116833
67126834 - `message: string`
67136835
6836 A human-readable explanation of the error. Its wording can change, so don't match on it.
6837
67146838 default: Request timeout
67156839
67166840 - `APIErrorObject object`
from line 6841
67176841
67186842 - `type: "api_error"`
67196843
6844 The broad category of the error.
6845
67206846 default: api_error
67216847
67226848 - `message: string`
67236849
6850 A human-readable explanation of the error. Its wording can change, so don't match on it.
6851
67246852 default: Internal server error
67256853
67266854 - `OverloadedError object`
from line 6855
67276855
67286856 - `type: "overloaded_error"`
67296857
6858 The broad category of the error.
6859
67306860 default: overloaded_error
67316861
67326862 - `message: string`
67336863
6864 A human-readable explanation of the error. Its wording can change, so don't match on it.
6865
67346866 default: Overloaded
67356867
67366868 - `request_id: string or null`
from line 7804
76727804
76737805 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
76747806
7807 - `"claude-fable-5-2"`
7808
7809 Built for the most ambitious work in coding, enterprise workflows, and the sciences
7810
7811 - `"claude-mythos-5-2"`
7812
7813 Built for the most demanding cybersecurity and life sciences research, available through verification programs
7814
76757815 - `"claude-haiku-5-5"`
76767816
76777817 Fastest model for high-volume, real-time tasks
from line 8111
79718111
79728112 - `type: "invalid_request_error"`
79738113
8114 The broad category of the error.
8115
79748116 default: invalid_request_error
79758117
79768118 - `message: string`
79778119
8120 A human-readable explanation of the error. Its wording can change, so don't match on it.
8121
79788122 default: Invalid request
79798123
79808124 - `AuthenticationError object`
from line 8125
79818125
79828126 - `type: "authentication_error"`
79838127
8128 The broad category of the error.
8129
79848130 default: authentication_error
79858131
79868132 - `message: string`
79878133
8134 A human-readable explanation of the error. Its wording can change, so don't match on it.
8135
79888136 default: Authentication error
79898137
79908138 - `BillingError object`
from line 8139
79918139
79928140 - `type: "billing_error"`
79938141
8142 The broad category of the error.
8143
79948144 default: billing_error
79958145
79968146 - `message: string`
79978147
8148 A human-readable explanation of the error. Its wording can change, so don't match on it.
8149
79988150 default: Billing error
79998151
80008152 - `PermissionError object`
from line 8153
80018153
80028154 - `type: "permission_error"`
80038155
8156 The broad category of the error.
8157
80048158 default: permission_error
80058159
80068160 - `message: string`
80078161
8162 A human-readable explanation of the error. Its wording can change, so don't match on it.
8163
80088164 default: Permission denied
80098165
80108166 - `NotFoundError object`
from line 8167
80118167
80128168 - `type: "not_found_error"`
80138169
8170 The broad category of the error.
8171
80148172 default: not_found_error
80158173
80168174 - `message: string`
80178175
8176 A human-readable explanation of the error. Its wording can change, so don't match on it.
8177
80188178 default: Not found
80198179
80208180 - `RateLimitError object`
from line 8181
80218181
80228182 - `type: "rate_limit_error"`
80238183
8184 The broad category of the error.
8185
80248186 default: rate_limit_error
80258187
80268188 - `message: string`
80278189
8190 A human-readable explanation of the error. Its wording can change, so don't match on it.
8191
80288192 default: Rate limited
80298193
80308194 - `GatewayTimeoutError object`
from line 8195
80318195
80328196 - `type: "timeout_error"`
80338197
8198 The broad category of the error.
8199
80348200 default: timeout_error
80358201
80368202 - `message: string`
80378203
8204 A human-readable explanation of the error. Its wording can change, so don't match on it.
8205
80388206 default: Request timeout
80398207
80408208 - `APIErrorObject object`
from line 8209
80418209
80428210 - `type: "api_error"`
80438211
8212 The broad category of the error.
8213
80448214 default: api_error
80458215
80468216 - `message: string`
80478217
8218 A human-readable explanation of the error. Its wording can change, so don't match on it.
8219
80488220 default: Internal server error
80498221
80508222 - `OverloadedError object`
from line 8223
80518223
80528224 - `type: "overloaded_error"`
80538225
8226 The broad category of the error.
8227
80548228 default: overloaded_error
80558229
80568230 - `message: string`
80578231
8232 A human-readable explanation of the error. Its wording can change, so don't match on it.
8233
80588234 default: Overloaded
80598235
80608236 - `request_id: string or null`
from line 8325
81498325
81508326 If the request input `messages` ended with an `assistant` turn, then the response `content` will continue directly from that last turn. You can use this to constrain the model's output.
81518327
8152 For example, if the input `messages` were:
8153
8154 ```json
8155 [
8156 {"role": "user", "content": "What's the Greek name for Sun? (A) Sol (B) Helios (C) Sun"},
8157 {"role": "assistant", "content": "The best answer is ("}
8158 ]
8159 ```
8160
8161 Then the response `content` might be:
8162
8163 ```json
8164 [{"type": "text", "text": "B)"}]
8165 ```
8166
8167 - `TextBlock object`
8168
8169 - `type: "text"`
8170
8171 default: text
8172
8173 - `citations: array of TextCitation or null`
8174
8175 Citations supporting the text block.
8176
8177 The type of citation returned will depend on the type of document being cited. Citing a PDF results in `page_location`, plain text results in `char_location`, and content document results in `content_block_location`.
8178
8179 - `CitationCharLocation object`
8180
8181 - `type: "char_location"`
8182
8183 default: char_location
8184
8185 - `cited_text: string`
8186
8187 - `document_index: number`
8188
8189 minimum: 0
8190
8191 - `document_title: string or null`
8192
8193 - `end_char_index: number`
8194
8195 - `file_id: string or null`
8196
8197 - `start_char_index: number`
8198
8199 minimum: 0
8200
8201 - `CitationPageLocation object`
8202
8203 - `type: "page_location"`
8204
8205 default: page_location
8206
8207 - `cited_text: string`
8208
8209 - `document_index: number`
8210
8211 minimum: 0
8212
8213 - `document_title: string or null`
8214
8215 - `end_page_number: number`
8216
8217 - `file_id: string or null`
8218
8219 - `start_page_number: number`
8220
8221 minimum: 1
8222
8223 - `CitationContentBlockLocation object`
8224
8225 - `type: "content_block_location"`
8226
8227 default: content_block_location
8228
8229 - `cited_text: string`
8230
8231 The full text of the cited block range, concatenated.
8232
8233 Always equals the contents of `content[start_block_index:end_block_index]` joined together. The text block is the minimal citable unit; this field is never a substring of a single block. Not counted toward output tokens, and not counted toward input tokens when sent back in subsequent turns.
8234
8235 - `document_index: number`
8236
8237 minimum: 0
8238
8239 - `document_title: string or null`
8240
8241 - `end_block_index: number`
8242
8243 Exclusive 0-based end index of the cited block range in the source's `content` array.
8244
8245 Always greater than `start_block_index`; a single-block citation has `end_block_index = start_block_index + 1`.
8246
8247 - `file_id: string or null`
8248
8249 - `start_block_index: number`
8250
8251 0-based index of the first cited block in the source's `content` array.
8252
8253 minimum: 0
8254
8255 - `CitationsWebSearchResultLocation object`
8256
8257 - `type: "web_search_result_location"`
8258
8259 default: web_search_result_location
8260
8261 - `cited_text: string`
8262
8263 - `encrypted_index: string`
8264
8265 - `title: string or null`
8266
8267 maxLength: 512
8268
8269 - `url: string`
8270
8271 - `CitationsSearchResultLocation object`
8272
8273 - `type: "search_result_location"`
8274
8275 default: search_result_location
8276
8277 - `cited_text: string`
8278
8279 The full text of the cited block range, concatenated.
8280
8281 Always equals the contents of `content[start_block_index:end_block_index]` joined together. The text block is the minimal citable unit; this field is never a substring of a single block. Not counted toward output tokens, and not counted toward input tokens when sent back in subsequent turns.
8282
8283 - `end_block_index: number`
8284
8285 Exclusive 0-based end index of the cited block range in the source's `content` array.
8286
8287 Always greater than `start_block_index`; a single-block citation has `end_block_index = start_block_index + 1`.
8288
8289 - `search_result_index: number`
8290
8291 0-based index of the cited search result among all `search_result` content blocks in the request, in the order they appear across messages and tool results.
8292
8293 Counted separately from `document_index`; server-side web search results are not included in this count.
8294
8295 minimum: 0
8296
8297 - `source: string`
8298
8299 - `start_block_index: number`
8300
8301 0-based index of the first cited block in the source's `content` array.
8302
8303 minimum: 0
8304
8305 - `title: string or null`
8306
8307 - `text: string`
8308
8309 - `ThinkingBlock object`
8310
8311 - `type: "thinking"`
8312
8313 default: thinking
8314
8315 - `signature: string`
8316
8317 A value used to verify that this thinking block was generated by Claude when it is passed back to the API.
8318
8319 This is an opaque field and should not be interpreted or parsed. When passing thinking blocks back to the API (required when using tools with extended thinking), pass them back exactly as received, with this field intact.
8320
8321 See [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking?sdk_languages=http) for details.
8322
8323 - `thinking: string`
8324
8325 The text of Claude's thinking process for this block.
8326
8327 - `RedactedThinkingBlock object`
8328
8329 - `type: "redacted_thinking"`
8330
8331 default: redacted_thinking
8332
8333 - `data: string`
8334
8335 The contents of this redacted thinking block, returned when portions of the model's thinking were safety-redacted. This field is opaque and encrypted, with no readable content.
8336
8337 Pass `redacted_thinking` blocks back to the API unchanged when continuing a multi-turn conversation.
8338
8339 See [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking?sdk_languages=http#redacted-thinking-blocks) for details.
8340
8341 - `ToolUseBlock object`
8342
8343 - `type: "tool_use"`
8344
8345 default: tool_use
8346
8347 - `id: string`
8348
8349 pattern: ^[a-zA-Z0-9_-]+$
8350
8351 - `caller: DirectCaller or ServerToolCaller or ServerToolCaller20260120`
8352
8353 default: {"type":"direct"}
8354
8355 - `DirectCaller object`
8356
8357 Tool invocation directly from the model.
8358
8359 - `type: "direct"`
8360
8361 - `ServerToolCaller object`
8362
8363 Tool invocation generated by a server-side tool.
8364
8365 - `type: "code_execution_20250825"`
8366
8367 - `tool_id: string`
8368
8369 pattern: ^srvtoolu_[a-zA-Z0-9_]+$
8370
8371 - `ServerToolCaller20260120 object`
8372
8373
8328 For example, if th
No line in this hunk matches that.