Delete Custom Domain
Permanently delete a custom domain your account owns, with its certificates and its stored (encrypted) DNS-provider credentials. A domain that still has endpoints can't be deleted (409) — delete those endpoints, or move them to another domain, first.
The domain's name is free again immediately: you (or anyone who proves control of it) can add it again right away. The certificate ngris issued for the domain is revoked in the background.
Rate-limited: 10 mutations/min/user on /domains/self.
Path parameters
uuid string (uuid) Req
Domain UUID.
Response (204 No Content)
No body.
Errors
401 Unauthorized
Missing auth.
403 Forbidden
Your role in the account can't delete domains, or the plan has no custom domains.
404 Not Found
Domain doesn't exist or doesn't belong to your active account.
409 Conflict
domain in use — endpoints still use the domain. Nothing was deleted.429 Too Many Requests
Rate limit hit (10/min/user).
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 — 204 No Content
(no body)
Was this helpful?