The connection's managed DNS zone

The hosted zone's status, the nameservers to set at the registrar, what the registry currently lists, the registrar, every record, and notes to show the user. Poll it while status is awaiting_delegation. 404 when managed DNS was never started for this connection.

get/connections/{id}/managed-dns

Request

Base URL: https://api.customdomain.ai/v1
URL: https://api.customdomain.ai/v1/connections/{id}/managed-dns
Auth: one of:
- HTTP bearer
- HTTP bearer

Path parameters

idstring required

Response

The zone

zonestring required

The hosted zone: the registrable domain.

status'awaiting_delegation' | 'active' | 'failed' required

awaiting_delegation: the zone holds the records; set the nameservers below at the registrar. active: every nameserver the registry lists is ours. failed: the switch never happened within 14 days, or the nameservers moved away again (the first warning says which); a failed zone keeps being checked and turns active once the delegation appears.

nameserversstring[] required

The nameservers to set at the registrar.

observed_nameserversstring[] required

The nameservers the registry listed at the last check.

warningsstring[] required

Plain-language notes for the user (a partial delegation, records a zone file import skipped, records replaced).

checked_atstring date-time required

When the delegation was last checked.

activated_atstring date-time nullable required

Example response

{
  "zone": "acme.com",
  "records": [
    {
      "id": "mdr_1f3a9c0b7d2e5a4c6b8d"
    }
  ]
}

Changes

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