Reset domain nameservers
DELETEhttps://api.instacloud.com/orgs/{orgId}/domains/{domainName}/nameservers
Token scope: account · org — read-only tokens refused (not a GET).
Point the domain back at the registrar's own nameservers, which is where an attach publishes. Never refused for a hostname in the way: this is the repair. (admin+)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
orgId | path | string | yes | |
domainName | path | string | yes |
Responses
200
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
domainName | string | yes | |
status | "registered" | "attaching" | "active" | "attach_failed" | "detached" | yes | detached: every service its hostnames named is gone — attach it again |
hostnames | object[] | yes | |
hostnames.hostname | string | yes | |
hostnames.state | "pending" | "attached" | "active" | "failed" | yes | |
hostnames.reason | string | no | |
hostnames.service | string | null | yes | the compute service this hostname serves; each hostname of a domain can serve a different one |
registeredAt | string | null | yes | |
expiresAt | string | null | yes | |
autorenew | boolean | yes | |
privacy | boolean | yes | |
locked | boolean | yes | the registrar transfer lock: while it is on, no other registrar can pull the domain away. Turn it off to move the domain out. What the last write reported, or what registration asked for — nothing reads it back |
nameservers | string[] | yes | what the registrar holds. Empty means never written — only a nameserver write fills it in |
delegated | boolean | yes | the zone is answered by nameservers InstaCloud cannot write to (custody `foreign`), so nothing published resolves and an attach is refused. A MANAGED delegation reads false: the platform still publishes there |
custody | "registrar" | "managed" | "foreign" | yes | who answers the domain's zone: the registrar's own nameservers, a managed InstaCloud zone (delegated, still platform-published), or somewhere the platform cannot write |
transferLockExpiresAt | string | null | yes | ICANN 60-day lock after registration: no transfer out before this, whatever `locked` says |
orderId | string | null | yes |
400
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
403
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
404
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
502
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
503
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |