The connection's managed DNS zone
The connection's managed DNS zone: CustomDomain™ API reference in the managed dns group. Covers request parameters, the request body, responses and error codes.
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. A widget token reads it only for its own end user's connection and only when the zone is that end user's (every connection linked to it is the token's, as for the start above); otherwise it gets 403 or 409 and none of the zone.
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
Response Body
application/json
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": "account_not_verifiable", "title": "string", "details": "string", "challenge": { "value": "string", "bits": 1, "expires_at": "2019-08-24T14:15:22Z" }}{ "code": "account_not_verifiable", "title": "string", "details": "string", "challenge": { "value": "string", "bits": 1, "expires_at": "2019-08-24T14:15:22Z" }}{ "code": "account_not_verifiable", "title": "string", "details": "string", "challenge": { "value": "string", "bits": 1, "expires_at": "2019-08-24T14:15:22Z" }}{ "code": "account_not_verifiable", "title": "string", "details": "string", "challenge": { "value": "string", "bits": 1, "expires_at": "2019-08-24T14:15:22Z" }}{ "code": "account_not_verifiable", "title": "string", "details": "string", "challenge": { "value": "string", "bits": 1, "expires_at": "2019-08-24T14:15:22Z" }}