Domains

Add and remove DNS records of a bought name (A, AAAA, CNAME, MX, TXT; or a preset). Applied onto the zone as it stands, every other record kept; a zone that changed since `version` answers 409 dns_changed. Records that follow the project cannot be changed

post/domain-registrations/domains/{domainId}/dns

Request

  • Base URL: https://hostingsurge.com/api/v1
  • URL: https://hostingsurge.com/api/v1/domain-registrations/domains/{domainId}/dns
  • Auth: one of:
    • HTTP bearer
    • API key in cookie __Host-hs_session

Path parameters

domainIdstring uuid required

Request body

versionstring required

the version the change is based on (from the list); a zone that changed meanwhile answers conflict

removestring[]

ids of records to remove

replaceboolean

records added take the place of the ones they clash with (the MX records there for a preset's MX, another SPF or DMARC record, records next to a CNAME); without it such a change answers conflict (conflicting_records) and nothing changes

Response

Saved

domainIdstring uuid required
domainstring required
projectIdstring uuid nullable required
projectNamestring nullable required
kind'dynadot_dns' | 'parking' | 'external' | 'unreadable' | 'not_in_account' required

dynadot_dns: Dynadot's DNS serves the name (the records below); parking: Dynadot's parking page (adding a record switches it to Dynadot's DNS); external: other nameservers serve it (manage its DNS there); unreadable: Dynadot's answer could not be read completely (nothing is changed unseen); not_in_account: the name is not in our registrar account (manage its DNS where it is registered)

editableboolean required

records can be changed here (Dynadot's DNS or its parking page, read completely)

messagestring nullable required

why they cannot, in plain words

nameserversstring[] required

external: the nameservers that serve the name, when Dynadot lists them

versionstring nullable required

the zone as read; send it with a change

ttlinteger nullable required

Dynadot keeps one TTL (seconds) for all of a name's records; null when its answer does not say

typesstring[] required

the types that can be added

Changes

No recorded changes to this operation across all 1 revision of this API.