DNS

Replace every record

PUT
/v1/domains/{id}/dns/records

Swaps the whole record set in one call, for keeping DNS in a system of your own. At most 200 records. Every record is checked first, so one bad record leaves the zone exactly as it was. The ids are new: these are new records, not edits of the ones they replace.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.

Path Parameters

id*string

Request Body

application/json
  1. body
records*array<>

The full new set. An empty list empties the zone

Itemsitems <= 200

Response Body

A hosted zone's records

application/json
  1. response

A hosted zone's records

records*array<>

Every record in the zone

curl -X PUT "https://example.com/v1/domains/dom_01K6XJ4Q8ZT3M9R5V2B7WDHNCA/dns/records" \  -H "Content-Type: application/json" \  -d '{    "records": [      {        "name": "www.acme.com",        "type": "A",        "content": "203.0.113.10"      }    ]  }'
{  "records": [    {      "id": "dns_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "name": "www.acme.com",      "type": "A",      "content": "203.0.113.10",      "ttl": 3600,      "priority": null,      "managedBy": null    }  ]}