AMQP-DELETE-QUEUE(1)

✨ NAME ✨

amqp-delete-queue — bestie, this is the little tool that deletes a queue from an AMQP server. bye queue 💅 (it's from the RabbitMQ C Client, iykyk)

---

🌸 SYNOPSIS 🌸

amqp-delete-queue [OPTION...] {-q queue name}

---

🦋 DESCRIPTION 🦋

okay so amqp-delete-queue deletes a queue from an AMQP server. that's the whole job. main character behavior, honestly 🎀

and then — this is the fun part — it exits after printing to standard output the number of messages that were in the queue at the time of its deletion. so it's not just a goodbye, it's a goodbye with receipts. you get to know exactly how many messages were sitting in there waiting when you pulled the plug 😭✨

---

💖 OPTIONS 💖

• -q, --queue=queue name — the name of the queue to delete. that's it, that's the one required thing. no queue name, no deletion, no slay 🫶

---

👑 EXIT STATUS 👑

• If the queue was successfully deleted, the exit status is 0. ate, no crumbs ✨
• If an error occurs, the exit status is 1. not the vibe 💀

---

🌈 EXAMPLES 🌈

Delete the queue “myqueue” at a moment when it has 123 messages waiting on it:

$ amqp-delete-queue -q myqueue
123

see that 123? that's the count of messages that were chillin' in there right before it got deleted. iconic. rip myqueue 🪦💜

---

🧚 SEE ALSO 🧚

librabbitmq-tools(7) describes connection-related options common to all the RabbitMQ C Client tools. fr fr go read it, the connection stuff lives there 🍓

---

⭐ AUTHOR ⭐

The RabbitMQ Team <info@rabbitmq.com> 💌

---

RabbitMQ C Client · 2026-10-13 — and that's the whole page bestie, mwah, go delete some queues responsibly 💖🎀🦋