API reference › Domains › Delete domain

Delete a domain

Stops tracking the domain. Nothing about it is checked again — the sweeper has no row left to pick up, its timeline entries and stored result are gone, and its externalId is free for a future registration to reuse. There is no undo; register it again to resume tracking, starting from pending.

No CLI command yet — removing a domain is API-only.

The request below is quoted verbatim from QUICKSTART.md.

curl -s -X DELETE https://api.propgate.dev/v1/domains/019fcf7a-2b3c-7d4e-9f5a-6b7c8d9e0f1a \
  -H "authorization: Bearer pg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "data": {
    "deleted": true,
    "id": "019fcf7a-2b3c-7d4e-9f5a-6b7c8d9e0f1a"
  },
  "error": null,
  "meta": null
}

An id that does not exist, or belongs to a different account, is a 404:

{
  "data": null,
  "error": {
    "message": "no such domain"
  },
  "meta": null
}