binding fail domain
Name
binding fail domain — fail messages for a domain on a binding with a bounce message
Synopsis
binding fail domain [ --dry-run ] [ --meta key value | --header header_name header_line ] { binding_name } { domain_name | all } [ message … ]
Description
The binding fail domain command allows the administrative failure of all messages bound for the specified domain on the specified binding. If political issues arise that cannot be resolved or if the domain has been discontinued, it may be necessary to fail all of the messages to that domain. Unless an optional message is passed, all failed messages will be assigned the following administrative failure message: "554 Message manually purged."
For example, the following command could be used to fail all messages for the domain unresolvableproblems.com on the binding BINDING1.
10:47:35 /tmp/2025> binding fail domain BINDING1 unresolvableproblems.com unresolvableproblems.com purged, 62415 messages failed.
You may substitute all for the domain name to apply to all domains.
10:47:35 /tmp/2025> binding fail domain BINDING1 all All domains purged. 62415 messages failed.
To pass in a custom failure message, you can append it to your command line, for instance:
10:47:35 /tmp/2025> binding fail domain BINDING1 unresolvableproblems.com 554 Administratively failed by Bob unresolvableproblems.com purged. 62415 messages failed.
Selective purge (optional filter)
Optional --meta / --header filtering matches fail domain quiet; --header respects physical-line matching. Place at most one clause after binding fail domain and before the binding name. Remaining tokens after the domain (or all) are still treated as the optional custom failure message when present.
To fail messages by the same filter without naming a binding or domain, use fail all or fail all quiet instead (filter required).
10:47:35 /tmp/2025> binding fail domain --meta mo_campaign_id promo BINDING1 unresolvableproblems.com 554 Purged campaign unresolvableproblems.com purged. 5 messages failed.
Preview without failing (--dry-run)
Add --dry-run to preview the command without failing any messages. The queue is left untouched; the messages that would be failed are listed (capped) and followed by a summary count:
10:47:35 /tmp/2025> binding fail domain --dry-run BINDING1 unresolvableproblems.com 3A/0F-04217-1A3F9C2B domain=unresolvableproblems.com from=<news@sender.com> to=<user@unresolvableproblems.com> 7C/1B-04217-2B4E0D8A domain=unresolvableproblems.com from=<promo@sender.com> to=<admin@unresolvableproblems.com> ... [dry-run] unresolvableproblems.com: 62415 messages would be failed. (Showing first 25; 62390 more not listed.)
When the domain is all, the summary reports [dry-run] all domains: …. See fail domain quiet → preview for the full description of the listing, the 25-message cap, and placement. --dry-run combines with the optional --meta / --header filter and is never consumed as part of the custom failure message.