Files
2026-07-09 21:46:20 -04:00

26 lines
914 B
Markdown

---
description: "Flush a KumoMTA queue with kcli rebind and --always-flush, re-evaluating and releasing messages for a domain across all tenants and campaigns."
---
# How do I flush a queue?
{{since('2024.09.02-c5476b89')}}
You can use `kcli rebind` for this; the following will flush `example.com` for all
tenant/campaigns:
```console
$ kcli rebind --reason "Cleaning up a bad send" --domain example.com --always-flush
```
`kcli rebind` re-evaluates the queue for messages in matching queues. In the
usage above, we're not passing in any new metadata, so the queue won't actually
change. The `--always-flush` parameter tells KumoMTA that it should make the
messages immediately eligible for delivery even though we didn't change the
queue.
If you want to do this via API, then
you should look at the
[/api/admin/rebind/v1](../reference/http/kumod/api_admin_rebind_v1_post.md) HTTP endpoint
documentation.