Skip to content

How do I flush a queue?

Since: Version 2024.09.02-c5476b89

The functionality described in this section requires version 2024.09.02-c5476b89 of KumoMTA, or a more recent version.

You can use kcli rebind for this; the following will flush example.com for all tenant/campaigns:

$ kcli rebind --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 HTTP endpoint documentation.