mxr unsubscribe
Generated from
mxr unsubscribe --help. After editingcrates/daemon/src/cli/, update and review the snapshots withscripts/cargo-test -p mxr --test integration cli_help::, then rebuildsite/.
Unsubscribe from a mailing list.
Positional argument accepts either a message id (uses the List-Unsubscribe header on that exact message) or an email address (alice@example.com). An address sends one request, from the newest message from that sender with a usable List-Unsubscribe method. On the same date, one-click beats a link, and a link beats mailto. Several addresses each get their own request. A sender that runs several lists needs one message id per list. --dry-run shows the requests before anything is sent. Combine with --search to scope an address to a label or date range.
mxr unsubscribe [OPTIONS] [MESSAGE_ID_OR_ADDRESS]...Arguments
Section titled “Arguments”| Flag | Description |
|---|---|
[MESSAGE_ID_OR_ADDRESS] |
… |
Options
Section titled “Options”| Flag | Description |
|---|---|
--yes |
|
--search <SEARCH> |
Scope an address’s unsubscribe to matching mail. Not with –purge, which acts on the whole sender footprint |
--account <ACCOUNT> |
|
--dry-run |
|
--purge |
Unsubscribe, then mark read and archive the sender’s whole footprint |
--archive-on-no-method |
With –purge, archive the footprint even if no List-Unsubscribe method exists |
--keep-mail |
With –purge, unsubscribe using the previewed method and keep existing mail |
--preview-token <PREVIEW_TOKEN> |
Commit an earlier –purge –dry-run preview exactly once. Requires –yes |
--format <FORMAT> |
[possible values: table, json, jsonl, csv, ids] |
-h, --help |
Print help (see a summary with ‘-h’) |
Use When
Section titled “Use When”Unsubscribe from a single message id, or from a sender by email address. An address sends one request, from the newest message from that sender with a usable List-Unsubscribe method. On the same date, one-click beats a link, and a link beats mailto. Several addresses each get their own request. A sender that runs several lists needs one message id per list. --dry-run shows the request. Combine with --search to scope the address.
Everyday Examples
Section titled “Everyday Examples”mxr unsubscribe alice@example.com --dry-runmxr unsubscribe alice@example.com bob@example.com --yesmxr unsubscribe MESSAGE_ID --dry-runmxr unsubscribe --search 'list:<news.example.com>' --dry-runSee also
Section titled “See also”- CLI overview: full command index
- Concepts: query operators, search modes, JSON shapes
- Automation contract: which commands support
--format json,--dry-run, stdin