Change nameserver delegation (vanity sets only)

PUT /domains/{domain}/nameservers

Operation ID: PutNameserversByDomain

Delegates the domain to one of the account’s vanity nameserver sets (vanity_set_id), or reverts it to the regfish standard nameservers (vanity_set_id: null). Free-form nameservers are intentionally NOT supported on this endpoint, externally hosted delegations must be managed in the regfish dash.

Guarded by the Domain-Guardian (ns_change rule class), domain status checks (pending transfer, cancellation) and two daily change limits: 5 changes per domain and 50 changes per account, both counted across all of your API keys and OAuth clients. Issuing another credential does not raise either limit.

Path parameters

Name	Type	Required	Description
domain	fqdn_relaxed	yes	-

Request body

nameserversUpdateRequest

Field	Type	Required	Description
vanity_set_id	integer	yes	Id of one of the account’s vanity nameserver sets, or null to revert to the regfish standard nameservers. Free-form nameservers are not supported on this endpoint.

Responses

Status	Type	Description
200	nameserversResponse	Delegation after the change
401	Error	Unauthorized
403	Error	Blocked by the Domain-Guardian
404	Error	Domain or vanity set not found
409	Error	Domain state or plan does not allow the change
429	Error	Daily change limit reached
500	Error	Unexpected error

Response body

Field	Type	Required	Description
success	boolean	yes	Success indicator
code	integer	no	Response/Error Code
response	nameserversResponse	no	-

Example

curl -X PUT "https://api.regfish.com/domains/<domain>/nameservers" \
  -H "x-api-key: $REGFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vanity_set_id": 0
  }'

Build a request

Fill in values - the call below updates as you type. Nothing is sent: the API does not currently allow browser requests from this domain (CORS). The API key is not stored.