Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
One change · api

Create a Message Batch changed

api/beta/messages/batches/create

Nearest release: v2.1.274, published 7 hours after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

Recorded here
Lines+144added
Lines−1removed
From line 21 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits11to this page, all time

The whole hunk

from line 21, old and new numbered
/
lines
from line 21
2121 
2222 - `string`
2323 
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`
2525 
2626 - `"message-batches-2024-09-24"`
2727 
from line 113
113113 
114114 - `"mid-conversation-system-clear-at-2026-08-21"`
115115 
116 - `"compact-2026-09-04"`
117 
116118- `"anthropic-user-profile-id": optional string`
117119 
118120 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 1305
13031305 
13041306 Opaque metadata from prior compaction, to be round-tripped verbatim
13051307 
1308 - `signature: optional string or null`
1309 
1310 The block's signature as returned, to be sent back verbatim
1311 
13061312 - `BetaRequestToolAdditionBlock object`
13071313 
13081314 Mid-conversation directive to surface a declared tool.
from line 1549
15431549 
15441550 Top-level cache control automatically applies a cache_control marker to the last cacheable block in the request.
15451551 
1552 - `compaction: optional BetaCompactionConfig or null`
1553 
1554 Compact the whole conversation and return a signed `compaction` block,
1555 alone, that a later request sends back first in `messages`, in place of
1556 the messages it summarizes. There is no trigger and no pause flag: sending
1557 the parameter compacts, and nothing is sampled after the block.
1558 
1559 The summarization prompt is the server's own unless `instructions` are
1560 given, which then replace it for this request; a value that is empty or
1561 only whitespace counts as absent.
1562 
1563 - `type: "summarize"`
1564 
1565 - `instructions: optional string or null`
1566 
1567 Replaces the server's default summarization prompt for this request. An empty or whitespace-only value counts as absent.
1568 
1569 maxLength: 16384
1570 
15461571 - `container: optional BetaContainerParams or string or null`
15471572 
15481573 Container identifier for reuse across requests.
from line 3486
34613486 
34623487 When true, guarantees schema validation on tool names and inputs
34633488 
3489 - `url_sources: optional BetaWebFetchURLSources or null`
3490 
3491 Which sources contribute to the set of URLs web fetch may fetch.
3492 
3493 Each key is a tagged variant: `user_input` is `all` or `none`; the
3494 two tool filters are `all`, `none`, `only` (only the named tools'
3495 results) or `except` (every result but the named tools'). A named tool
3496 must be declared in this request's `tools[]`.
3497 
3498 - `client_tool_results: optional BetaWebFetchURLSourceAll or BetaWebFetchURLSourceNone or BetaWebFetchURLSourceOnly or BetaWebFetchURLSourceExcept`
3499 
3500 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
3501 
3502 - `BetaWebFetchURLSourceAll object`
3503 
3504 The `url_sources` variant under which a source contributes in
3505 full: every result of the tool filter's source, or all user input.
3506 
3507 - `type: "all"`
3508 
3509 - `BetaWebFetchURLSourceNone object`
3510 
3511 The `url_sources` variant under which a source contributes nothing:
3512 no result of the tool filter's source, or no user input.
3513 
3514 - `type: "none"`
3515 
3516 - `BetaWebFetchURLSourceOnly object`
3517 
3518 The tool filter variant under which only the named tools' results
3519 contribute.
3520 
3521 - `type: "only"`
3522 
3523 - `tools: array of BetaWebFetchURLSourceToolReference`
3524 
3525 - `type: "tool_reference"`
3526 
3527 - `name: string`
3528 
3529 - `BetaWebFetchURLSourceExcept object`
3530 
3531 The tool filter variant under which every result but the named
3532 tools' contributes.
3533 
3534 - `type: "except"`
3535 
3536 - `tools: array of BetaWebFetchURLSourceToolReference`
3537 
3538 - `type: "tool_reference"`
3539 
3540 - `name: string`
3541 
3542 - `server_tool_results: optional BetaWebFetchURLSourceAll or BetaWebFetchURLSourceNone or BetaWebFetchURLSourceOnly or BetaWebFetchURLSourceExcept`
3543 
3544 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
3545 
3546 - `BetaWebFetchURLSourceAll object`
3547 
3548 The `url_sources` variant under which a source contributes in
3549 full: every result of the tool filter's source, or all user input.
3550 
3551 - `BetaWebFetchURLSourceNone object`
3552 
3553 The `url_sources` variant under which a source contributes nothing:
3554 no result of the tool filter's source, or no user input.
3555 
3556 - `BetaWebFetchURLSourceOnly object`
3557 
3558 The tool filter variant under which only the named tools' results
3559 contribute.
3560 
3561 - `BetaWebFetchURLSourceExcept object`
3562 
3563 The tool filter variant under which every result but the named
3564 tools' contributes.
3565 
3566 - `user_input: optional BetaWebFetchURLSourceAll or BetaWebFetchURLSourceNone`
3567 
3568 Whether URLs in user messages are fetchable: "all" or "none".
3569 
3570 - `BetaWebFetchURLSourceAll object`
3571 
3572 The `url_sources` variant under which a source contributes in
3573 full: every result of the tool filter's source, or all user input.
3574 
3575 - `BetaWebFetchURLSourceNone object`
3576 
3577 The `url_sources` variant under which a source contributes nothing:
3578 no result of the tool filter's source, or no user input.
3579 
34643580 - `BetaWebSearchTool20260209 object`
34653581 
34663582 - `type: "web_search_20260209"`
from line 3683
35673683 
35683684 When true, guarantees schema validation on tool names and inputs
35693685 
3686 - `url_sources: optional BetaWebFetchURLSources or null`
3687 
3688 Which sources contribute to the set of URLs web fetch may fetch.
3689 
3690 Each key is a tagged variant: `user_input` is `all` or `none`; the
3691 two tool filters are `all`, `none`, `only` (only the named tools'
3692 results) or `except` (every result but the named tools'). A named tool
3693 must be declared in this request's `tools[]`.
3694 
35703695 - `BetaWebFetchTool20260309 object`
35713696 
35723697 Web fetch tool with use_cache parameter for bypassing cached content.
from line 3750
36253750 
36263751 When true, guarantees schema validation on tool names and inputs
36273752 
3753 - `url_sources: optional BetaWebFetchURLSources or null`
3754 
3755 Which sources contribute to the set of URLs web fetch may fetch.
3756 
3757 Each key is a tagged variant: `user_input` is `all` or `none`; the
3758 two tool filters are `all`, `none`, `only` (only the named tools'
3759 results) or `except` (every result but the named tools'). A named tool
3760 must be declared in this request's `tools[]`.
3761 
36283762 - `use_cache: optional boolean`
36293763 
36303764 Whether to use cached content. Set to false to bypass the cache and fetch fresh content. Only set to false when the user explicitly requests fresh content or when fetching rapidly-changing sources.
from line 3884
37503884 - `strict: optional boolean`
37513885 
37523886 When true, guarantees schema validation on tool names and inputs
3887 
3888 - `url_sources: optional BetaWebFetchURLSources or null`
3889 
3890 Which sources contribute to the set of URLs web fetch may fetch.
3891 
3892 Each key is a tagged variant: `user_input` is `all` or `none`; the
3893 two tool filters are `all`, `none`, `only` (only the named tools'
3894 results) or `except` (every result but the named tools'). A named tool
3895 must be declared in this request's `tools[]`.
37533896 
37543897 - `use_cache: optional boolean`
37553898