Skip to content
Docs
Open Escouade
Documentation contents

Docs › Mail › Tools

remove_domain

View as .md

Remove a domain.

Removes a domain from the space: no more inboxes are created on it, and the mail server stops receiving its mail. Do this before pointing the domain’s MX elsewhere. Refused while one of the space’s inboxes lives on this domain (delete them first). Then remember to remove its records from your DNS. Irreversible: pass confirm = true; registering it again will give new DKIM keys.

Access

  • Key: an Escouade Mail key with manage_inboxes.
  • Space: a verified space.
  • Changes nothing: no, it acts.
  • Safe to replay: use an idempotency_key where the tool offers one.

Parameters

ParameterTypeRequiredDescription
domainstringyesThe domain to remove (see list_domains).
confirmbooleanyesMust be true: removal is irreversible.

Call it

Terminal
curl -s https://api.subagent.fr/v1/remove_domain \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{"domain": "…", "confirm": "…"}'

The full page in French, with the response fields and every refusal the tool can return: /mail/docs/reference/remove_domain.