XGROUP-DESTROY(3valkey)

💅 XGROUP-DESTROY — it's giving "bye bye consumer group" 💅

okay bestie, this one lives in the Valkey Command Manual and it's literally called XGROUP-DESTROY, section 3valkey. buckle up 🎀

---

✨ NAME ✨

xgroup-destroy — destroys a consumer group. that's it. that's the whole job. 🦋

---

✨ SYNOPSIS ✨

XGROUP DESTROY key group

---

✨ DESCRIPTION ✨

so the XGROUP DESTROY command completely destroys a consumer group. not "kind of", not "softly", not "we'll talk about it later" — completely. 💀

and the tea is: the consumer group gets destroyed even if there are active consumers, and even if there are pending messages still hanging around. so please, only call this command when you really truly need it, okay? this is not a "whoops lol" kind of command, this is a "main character makes a decision" kind of command. 👑

⚠️ no cap — active consumers + pending messages do not save the group. they all get taken out with it. make sure you actually want that.

---

✨ REPLY ✨

valkey-protocol(7) Integer reply: the number of destroyed consumer groups, either 0 or 1. so you get a lil number back and it's telling you if the group was actually yeeted or not. 🌸

---

✨ COMPLEXITY ✨

O(N) where N is the number of entries in the group's pending entries list (PEL). 🧚

---

✨ ACL CATEGORIES ✨

@slow @stream @write

---

✨ HISTORY ✨

• Available since: 5.0.0 ⭐

---

✨ SEE ALSO ✨

xack(3valkey), xadd(3valkey), xautoclaim(3valkey), xclaim(3valkey), xdel(3valkey), xgroup(3valkey), xgroup-create(3valkey), xgroup-createconsumer(3valkey), xgroup-delconsumer(3valkey), xgroup-help(3valkey), xgroup-setid(3valkey), xinfo(3valkey), xinfo-consumers(3valkey), xinfo-groups(3valkey), xinfo-help(3valkey), xinfo-stream(3valkey), xlen(3valkey), xpending(3valkey), xrange(3valkey), xread(3valkey), xreadgroup(3valkey), xrevrange(3valkey), xsetid(3valkey), xtrim(3valkey) 💜

---

okay that's the whole page bestie, you ate it, go destroy some consumer groups responsibly 🫶

version 9.0.0, dated 2025-10-21 — slay, periodt, iykyk ✨🎀🦋