---
title: "Changes to Bulk Cancel Messages"
method: DELETE
path: "/v2/messages"
---

# Changes to Bulk Cancel Messages

`DELETE /v2/messages`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 17 revisions.

- **2026-09-16** `ed23e37f87f3`: 1 breaking, 6 info
- **2026-06-10** `6afae1d18547`: 2 warning, 10 info
- **2026-06-09** `d30bd0904328`: 1 info
- **2026-06-09** `d859c277ced2`: 1 info
- **2026-05-15** `75ecd1c6fb73`: 1 info

## Changes

- **2026-09-16** `ed23e37f87f3`: 1 breaking, 6 info
  - removed the success response with the status `200`
  - added the new optional `query` request parameter `async`
  - `query` request parameter `count` was deprecated
  - added the non-success response with the status `400`
  - added the non-success response with the status `412`
  - added the non-success response with the status `429`
  - added the success response with the status `202`
- **2026-06-10** `6afae1d18547`: 2 warning, 10 info
  - for the `query` request parameter `count`, the max was set to `500.00`
  - for the `query` request parameter `count`, the min was set to `1.00`
  - added the new optional `query` request parameter `callerIp`
  - added the new optional `query` request parameter `host`
  - added the new optional `query` request parameter `path`
  - `query` request parameter `callerIP` was deprecated
  - for the `query` request parameter `callerIP`, the type was generalized from `string` to `array`
  - for the `query` request parameter `flowControlKey`, the type was generalized from `string` to `array`
  - for the `query` request parameter `queueName`, the type was generalized from `string` to `array`
  - for the `query` request parameter `scheduleId`, the type was generalized from `string` to `array`
  - for the `query` request parameter `topicName`, the type was generalized from `string` to `array`
  - for the `query` request parameter `url`, the type was generalized from `string` to `array`
- **2026-06-09** `d30bd0904328`: 1 info
  - for the `query` request parameter `label`, the type was generalized from `string` to `array`
- **2026-06-09** `d859c277ced2`: 1 info
  - for the `query` request parameter `label`, the type was generalized from `array` to `string`
- **2026-05-15** `75ecd1c6fb73`: 1 info
  - for the `query` request parameter `label`, the type was generalized from `string` to `array`

---

[Operation](https://skmtc.dev/upstash/apis/qstash-rest-api/docs/v2/messages/delete.md) - [API](https://skmtc.dev/upstash/apis/qstash-rest-api.md) - [Page](https://skmtc.dev/upstash/apis/qstash-rest-api/changes/v2/messages/delete)