CustomDomain™ docs
API referenceManaged DNS

The connection's managed DNS zone

GET
/connections/{id}/managed-dns

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.

AuthorizationBearer <token>

Long-lived tenant API key, cd_live_… (production) or cd_test_… (staging, development), stored hashed. Keys created before the switch to cd_ start with sk_live_… / sk_test_… and are still accepted. Scoped to the owning application's tenant.

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/connections/string/managed-dns"
{  "zone": "acme.com",  "status": "awaiting_delegation",  "nameservers": [    "string"  ],  "observed_nameservers": [    "string"  ],  "registrar": {    "name": "string",    "url": "string"  },  "records": [    {      "id": "mdr_1f3a9c0b7d2e5a4c6b8d",      "type": "A",      "name": "string",      "value": "string",      "ttl": 0,      "priority": 0,      "source": "discovered"    }  ],  "warnings": [    "string"  ],  "checked_at": "2019-08-24T14:15:22Z",  "activated_at": "2019-08-24T14:15:22Z"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}