Follow Discord
Sweep 22 Oct 2026 · 21:04Z Build v2.1.309 528 read Stable v2.1.308 Latest v2.1.309 Next v2.1.309 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeDocsClaude Developer Platform 25 Aug 2026
One change · api

Delete a Message Batch changedapi/beta/messages/batches/delete

Nearest release: v2.1.245, published an hour 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+10added
Lines−15removed
From line 1 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits17to this page, all time

# Delete a Message Batch ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Delete a Message Batch ### Path Parameters ### Header Parameters ### Returns ### Example #### Response

The whole hunk

from line 1, old and new numbered
/
lines
from line 1
1---
2title: Delete a Message Batch
3url: https://platform.claude.com/docs/en/api/beta/messages/batches/delete
4---
1# Delete a Message Batch
52 
6## Delete a Message Batch
3**DELETE** `/v1/messages/batches/{message_batch_id}`
74 
8**delete** `/v1/messages/batches/{message_batch_id}`
9 
105Delete a Message Batch.
116 
127Message Batches can only be deleted once they've finished processing. If you'd like to delete an in-progress batch, you must first cancel it.
from line 8
138 
149Learn more about the Message Batches API in our [user guide](https://platform.claude.com/docs/en/build-with-claude/batch-processing)
1510 
16### Path Parameters
11## Path parameters
1712 
1813- `message_batch_id: string`
1914 
2015 ID of the Message Batch.
2116 
22### Header Parameters
17## Headers
2318 
2419- `"anthropic-beta": optional array of AnthropicBeta`
2520 
from line 92
9792 
9893 - `"mid-conversation-tool-changes-2026-07-01"`
9994 
100### Returns
95## Returns
10196 
102- `BetaDeletedMessageBatch object { id, type }`
97- `BetaDeletedMessageBatch object`
10398 
10499 - `id: string`
105100 
from line 106
111106 
112107 For Message Batches, this is always `"message_batch_deleted"`.
113108 
114 - `"message_batch_deleted"`
109 default: message_batch_deleted
115110 
116### Example
111## Example
117112 
118```http
113```bash
119114curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID \
120115 -X DELETE \
121116 -H 'anthropic-version: 2023-06-01' \
from line 118
123118 -H "X-Api-Key: $ANTHROPIC_API_KEY"
124119```
125120 
126#### Response
121### Response (200)
127122 
128123```json
129124{
Feedback