Move the domain's nameservers back
Move the domain's nameservers back: CustomDomain™ API reference in the nameservers group. Lists request parameters, the request body, responses and error codes.
Moves the domain back, to one of two places (rollback_target): the nameservers it had before (previous), or the registrar's own DNS (registrar_default). Without a choice: the old nameservers while they still answer for the zone, else the registrar's own DNS. The old nameservers are asked first, because a DNS host may have deleted the zone since (Cloudflare deletes a moved zone after 7 days); moving back to ones that no longer answer is refused (409 old_dns_gone). A move back to a domain that used the registrar's own DNS at the start goes through the registrar's reset call, not its names set as custom ones. With a key (sent once, or the migration's connected account) the registrar's API makes it (rollback_path: api); otherwise the cloud browser (agent) or a person (manual, next_step says what to set or choose). A migration that changed nothing at the registrar yet is simply stopped (none). Any cloud browser session still working on the move is ended first. Idempotent. A widget token may move back, and choose where, but may not send a key. A delegated agent token needs domains:connect.
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
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/connections/string/nameservers:rollback" \ -H "Content-Type: application/json" \ -d '{}'{ "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"}{ "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"}{ "code": "string", "title": "string", "details": "string"}{ "code": "string", "title": "string", "details": "string"}{ "code": "string", "title": "string", "details": "string"}