Delete DNS Record
Remove a DNS record from your custom domain. The platform proxies the delete to your provider live; on success the record is gone immediately (TTL caching elsewhere on the internet may keep stale answers around).
Idempotent in the SDK — a 404 from "record already deleted" is treated as success on the client side. The server still returns 404 strictly so logs/dashboards can distinguish.
Path parameters
uuid string (uuid) Req
Domain UUID.
record_id string Req
Provider-assigned record ID.
Response (204 No Content)
Empty body on success.
Errors
400 Bad Request
Domain has no DNS provider configured.
401 Unauthorized
Missing auth.
404 Not Found
Domain or record doesn't exist (or doesn't belong to the calling user). The SDK swallows this for idempotency.
502 Bad Gateway
Provider rejected the delete (rare).
Request
curl -X DELETE "https://api.ngris.com/v1/domains/self/<uuid>/dns-records/<record_id>" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
client.domains.delete_dns_record("<domain_uuid>", "<record_id>")
# Idempotent — already-deleted (404) is treated as success.
Response — 204 No Content