Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
RRsets

Update RRset

Create/update RRset.

put/dns/v2/zones/{zoneName}/{rrsetName}/{rrsetType}

Path parameters

zoneNamestring required
rrsetNamestring required
rrsetTypestring required

Request body

metaobject

Meta information for rrset

ttlinteger

Example request

{
  "meta": {}
}

Response

OutputRRSet

filter_set_idinteger
metaobject

Meta information for rrset. Map with string key and any valid json as value, with valid keys

  1. failover (object, beta feature, might be changed in the future) can have fields 1.1. protocol (string, required, HTTP, TCP, UDP, ICMP) 1.2. port (int, required, 1-65535) 1.3. frequency (int, required, in seconds 10-3600) 1.4. timeout (int, required, in seconds 1-10), 1.5. method (string, only for protocol=HTTP) 1.6. command (string, bytes to be sent only for protocol=TCP/UDP) 1.7. url (string, only for protocol=HTTP) 1.8. tls (bool, only for protocol=HTTP) 1.9. regexp (string regex to match, only for non-ICMP) 1.10. http_status_code (int, only for protocol=HTTP) 1.11. host (string, only for protocol=HTTP)
  2. geodns_link (string) - name of the geodns link to use, if previously set, must re-send when updating or CDN integration will be removed for this RRSet
namestring required
ttlinteger
type'A' | 'AAAA' | 'NS' | 'CNAME' | 'MX' | 'TXT' | 'SRV' | 'SOA' required

RRSet type

updated_atstring date-time

Timestamp marshals/unmarshals date and time as timestamp in json

warningstring

Warning about some possible side effects without strictly disallowing operations on rrset readonly Deprecated: use Warnings instead

Example response

{
  "meta": {},
  "name": "sub.example.com",
  "resource_records": [
    {
      "id": 42
    }
  ]
}