CustomDomain™ docs
Nameservers

One application's nameserver migrations and their analytics

One application's nameserver migrations and their analytics: CustomDomain™ API reference. Lists request parameters, the request body, responses and error codes.

GET
/applications/{id}/nameserver-migrations

The application's nameserver migrations, newest first, with their analytics: counts per state, path and target, the median time to active, how many waited on DNSSEC and for how long, failures by code, rollbacks and drifts. Only this application's migrations; since narrows both the list and the analytics.

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

Query Parameters

limit?integer
Range1 <= value <= 200
Default50
since?string

Keep the migrations created at or after this time (RFC 3339).

Formatdate-time

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/applications/string/nameserver-migrations"
{  "migrations": [    {      "id": "string",      "connection_id": "string",      "zone": "string",      "state": "pending",      "path": "api",      "target": "managed",      "dns_host": "string",      "provider": "string",      "registrar": {        "name": "string",        "provider": "string",        "iana_id": 0,        "url": "string",        "source": "rdap"      },      "old_dns_host": "string",      "old_nameservers": [        "string"      ],      "new_nameservers": [        "string"      ],      "observed_nameservers": [        "string"      ],      "waiting_for": "zone_ready",      "next_step": "string",      "failure_code": "zone_copy_failed",      "failure_detail": "string",      "records_copied": 0,      "email_records": 0,      "email_kinds": [        "mx"      ],      "copy_source": "api",      "copy_warnings": [        "string"      ],      "copy_reviewed_at": "2019-08-24T14:15:22Z",      "ds_present": true,      "ds_removed_at": "2019-08-24T14:15:22Z",      "ds_cleared_at": "2019-08-24T14:15:22Z",      "can_rollback": true,      "rollback_path": "api",      "rollback_targets": [        "previous"      ],      "rollback_default": "previous",      "rollback_target": "previous",      "rollback_set_at": "2019-08-24T14:15:22Z",      "old_dns_serves": true,      "consent": {        "id": "string",        "version": "string",        "at": "2019-08-24T14:15:22Z"      },      "actor": "end_user",      "created_at": "2019-08-24T14:15:22Z",      "set_at": "2019-08-24T14:15:22Z",      "active_at": "2019-08-24T14:15:22Z",      "failed_at": "2019-08-24T14:15:22Z",      "rolled_back_at": "2019-08-24T14:15:22Z",      "drifted_at": "2019-08-24T14:15:22Z",      "checked_at": "2019-08-24T14:15:22Z",      "next_check_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "stats": {    "by_state": {      "property1": 0,      "property2": 0    },    "by_path": {      "property1": 0,      "property2": 0    },    "by_target": {      "property1": 0,      "property2": 0    },    "by_registrar": {      "property1": 0,      "property2": 0    },    "by_old_dns_host": {      "property1": 0,      "property2": 0    },    "total": 0,    "started": 0,    "active": 0,    "median_seconds_to_active": 0,    "dnssec_waits": 0,    "median_seconds_dnssec_wait": 0,    "failures_by_code": {      "property1": 0,      "property2": 0    },    "rolled_back": 0,    "drifted": 0  }}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}