GoDaddy
Support
API ReferenceDomainDomain LifecycleDomains & DNSv3 (Recommended)RecordsDelete a DNS record DELETE

Delete a DNS record

View as Markdown

Permanently removes a DNS record from the zone.

Full description

Permanently removes a DNS record from the zone. The recordId must refer to an existing record in the specified zone. Changes are applied synchronously. GoDaddy-managed records (SOA, NS) are read-only and return 409 when targeted.

DELETE
/zones/{zone}/dns-records/{recordId}

Authorization

bearerAuth
AuthorizationBearer <token>

Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer <token>.

In: header

Path Parameters

zone*string

The domain name in punycode A-label form (for example, example.com). For IDNs, use the punycode representation.

recordId*string

Server-assigned DNS record identifier within the zone.

Header Parameters

X-Request-Id?string

Optional client-generated request correlation identifier, propagated across services and returned in the response X-Request-Id header.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/zones/example.com/dns-records/Aad7oqdXCms9mlJvm_m6UFYqmwjyP20H2KBmQHgttK9kGbF_TuI3knsocArQqIv5I0Kq5C0"
Empty

Agent & Automation Notes

Scopesdomains.domain:read, domains.domain:create, domains.dns:update, domains.nameserver:update
Rate limit60 req/min per credential
On failureGET operations are safe to retry. POST registrations use Idempotency-Key. Poll async operations — do not resubmit.

Related

Last updated on

How is this guide?