API ReferenceDomainDomain LifecycleDomains & DNSv1 (Legacy)Manage DNSReplace all DNS Records for the specified Domain PUT
Replace all DNS Records for the specified Domain
View as MarkdownReplaces the entire DNS record set for the domain.
Full description
Replaces the entire DNS record set for the domain. All existing records are removed and replaced with the submitted set. Returns 204 No Content.
Authorization
bearerAuth AuthorizationBearer <token>
Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer .
In: header
Path Parameters
domain*string
Domain whose DNS Records are to be replaced
Header Parameters
X-Shopper-Id?string
Shopper ID which owns the domain. NOTE: This is only required if you are a Reseller managing a domain purchased outside the scope of your reseller account.
DNS Records to replace whatever currently exists
[index: integer]?
Response Body
curl -X PUT "https://example.com/v1/domains/string/records" \ -H "Content-Type: application/json" \ -d '[ { "data": "string", "name": "string", "type": "A" } ]'Empty
Agent & Automation Notes
Scopes
domains.domain:read, domains.domain:create, domains.domain:delete, domains.domain:update, domains.contact:update, domains.dns:update, domains.transfer:executeRate limit60 req/min per credential
On failureGET operations are safe to retry. PUT/PATCH DNS are idempotent by shape. POST purchase is NOT idempotent — verify state before retrying.
Related
Last updated on
How is this guide?