Delete a domain you no longer use

DELETE /api/admin/domains/{hostname} removes a domain and everything configured on it — but only once nothing public still depends on it.

Why it might refuse (409)

A delete is blocked, not queued, when any of these are still true — fix the underlying thing first, there's no force-delete:

Code	Meaning	Fix
`domain_public_address_active`	This channel's own public address is currently an alias elsewhere (`primary_address` is set)	Move it back to its own host first
`domain_carries_public_addresses`	Another channel's alias still resolves through this hostname	Move that channel off it first
`domain_has_qr_codes`	Printed QR codes reference this address	Turn those carriers off or regenerate them
`domain_migration_active`	A rotation to or from this domain is still running	Finish or roll back the migration first

Once the guards pass, deleting a domain in one transaction:

Hard-deletes its buttons, notifications, background config, segments, visibility rules, locale config, of_links, redirect slots, smart links, and creator links.
Preserves money history: OfLinkStat rows (the cumulative link snapshots) are kept — only their link reference is cleared, never the rows themselves.
Removes local asset directories (notification media, backgrounds, both draft and published).
Deprovisions the nginx site and certificate on the server.
Re-exports the draft and published runtime and resets the domain/slug/relay caches, so the hostname stops resolving to anything immediately.

Not ready to lose the config, just want traffic somewhere else? See Move off a burned domain instead of deleting.