v51

OpenAPI 3.0.0raw.githubusercontent.com2026-08-01267339950.6 KB
DNS: Zone

Validate DNS records

Validate DNS records prior to update for the selected domain.

If the validation is successful, the response will contain 200 Success code. If there is validation error, the response will fail with 422 Validation error code.

Use this endpoint to verify DNS record validity before applying changes.

post/api/dns/v1/zones/{domain}/validate

Path parameters

domainstring required
Example:mydomain.tld

Domain name

Request body

overwriteboolean

If true, resource records (RRs) matching name and type will be deleted and new RRs will be created, otherwise resource records' ttl's are updated and new records are appended. If no matching RRs are found, they are created.

Example request

{
  "overwrite": true,
  "zone": [
    {
      "name": "www",
      "records": [
        {
          "content": "mydomain.tld."
        }
      ],
      "ttl": 14400,
      "type": "A"
    }
  ]
}

Response

Success response

messagestring

Example response

{
  "message": "Request accepted"
}