Delete Custom Domain
Remove a custom domain you own. Endpoints currently anchored on this domain are not automatically deleted — they remain in the database with a stale domain_id and stop resolving publicly until you reassign them to a different domain. Either delete those endpoints first or move them to another domain.
The platform-managed ACME certificate for this domain is revoked and removed from the cert cache. Encrypted DNS-provider credentials are deleted from the database.
Rate-limited: 10 mutations/min/user on /domains/self.
Path parameters
uuid string (uuid) Req
Domain UUID.
Response (200 OK)
status string
"deleted" on success.orphaned_endpoints int?
Number of endpoints that still reference the deleted domain. Reassign or delete them — they don't resolve until you do.
Errors
401 Unauthorized
Missing auth.
404 Not Found
Domain doesn't exist or doesn't belong to the calling user.
429 Too Many Requests
Rate limit hit (10/min/user).
500
Cleanup failure (cert revocation or DNS-provider call). Domain row is removed regardless; safe to retry but the cleanup may already be done.
Request
curl -X DELETE "https://api.ngris.com/v1/domains/self/<uuid>" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
client.domains.delete("<domain_uuid>")
Response — 200 OK
{
"status": "deleted",
"orphaned_endpoints": 0
}