Sign inGet Started

bird email domains delete

Usage

Code example
bird email domains delete <domain-id> [flags]

Description

Delete a sending domain by ID. Revokes its sender authorization: new sends from the domain are rejected afterward, while historical statistics and events for past sends are preserved. Returns 409 while this assignment owns receiving, or while its removal would leave a retained receiving claim without an assignment. Disable receiving, then poll the domain until capabilities.inbound.status is not_configured before retrying deletion. Destructive.

This is destructive and cannot be undone; pass --yes to confirm.

Examples

Code example
bird email domains delete <id> --yes

Options

Safety

NameDescription
--idempotency-keyDeduplication key; a retry with the same key won't act twice
--yesConfirm the action (required; the CLI never prompts)
NameDescription
bird email domains createAdd a sending domain and return the DNS records to configure
bird email domains getGet a sending domain
bird email domains listList sending domains
bird email domains updateUpdate a sending domain's tracking settings and tracking domain
bird email domains verifyVerify a domain

Continue with the documentation, guides and examples for this topic.