---
title: "Changes to Clear a queue"
method: POST
path: "/v1/queue.clear"
---

# Changes to Clear a queue

`POST /v1/queue.clear`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 16 revisions.

- **2026-07-17** `b67c2fa641f7` — 1 breaking
- **2025-06-05** `db1e2b747f3c` — 3 breaking
- **2025-04-21** `3de0078c9268` — 1 breaking, 1 warning
- **2024-09-16** `22a36c374092` — 1 breaking
- **2024-09-15** `ba3240950bb2` — 2 breaking, 1 warning, 4 info

## Changes

- **2026-07-17** `b67c2fa641f7` — 1 breaking
  - request body became required
- **2025-06-05** `db1e2b747f3c` — 3 breaking
  - the response property `code_text` became optional for the status `200`
  - the response property `message` became optional for the status `200`
  - removed the required property `details` from the response with the `200` status
- **2025-04-21** `3de0078c9268` — 1 breaking, 1 warning
  - added the new required request property `retry`
  - removed the request property `defer`
- **2024-09-16** `22a36c374092` — 1 breaking
  - the `destructive` request property type/format changed from `string`/`` to `boolean`/``
- **2024-09-15** `ba3240950bb2` — 2 breaking, 1 warning, 4 info
  - added the new required request property `defer`
  - the `destructive` request property type/format changed from `boolean`/`` to `string`/``
  - removed the request property `retry`
  - request body became optional
  - the response property `code_text` became required for the status `200`
  - the response property `message` became required for the status `200`
  - added the required property `details` to the response with the `200` status

---

[Operation](https://skmtc.dev/kapetan-io/apis/querator-api/docs/v1/queue.clear/post.md) · [API](https://skmtc.dev/kapetan-io/apis/querator-api.md) · [Page](https://skmtc.dev/kapetan-io/apis/querator-api/changes/v1/queue.clear/post)