---
title: "Delete a queue"
method: POST
path: "/v1/queues.delete"
tags: ["Querator V1"]
---

# Delete a queue

`POST /v1/queues.delete`

Delete a queue and all associated data. Use the force parameter to delete queues that have active items or leases.

## Request body

- QueuesDeleteRequest
  - `queue_name` string, required — The name of the queue to delete
  - `force` boolean, required — force indicates the deletion should ignore any current open leases or items in the queue and delete all data related to the queue. In addition, this forcibly cancels all in progress client lease requests.

## Response `200`

- Reply
  - `code` integer, required — Response status code
  - `code_text` string — Human readable status message
  - `message` string — Additional details about the response

## Changes

- **2026-07-17** `b67c2fa641f7` — 1 breaking
  - request body became required
- **2025-06-05** `db1e2b747f3c` — 1 info
  - endpoint added
- **2024-09-15** `ba3240950bb2` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/kapetan-io/apis/querator-api/changes/v1/queues.delete/post.md)

---

[API](https://skmtc.dev/kapetan-io/apis/querator-api.md) · [All operations](https://skmtc.dev/kapetan-io/apis/querator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kapetan-io/querator-api/revisions/b67c2fa641f7/schema)