29tools
New · MCP SuiteYour infrastructure now talks to AI agents.

Claude, Codex & co. manage DNS, domains and certificates directly, including DNS Doctor diagnostics.

Explore the MCP Suite
DNS automation
v1.6.2
Download OpenAPI
Change nameserver delegation (vanity sets only)
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 a daily per-domain change limit.
PUT
/domains/{domain}/nameservers
Domains

Authentication

x-api-keyapplication/json

Parameters

Name
Type
Format
Required
Description
domain
path
string
-
Required
Fully Qualified Domain Name.

Request body

application/jsonRequired
No description was provided in the specification.
nameserversUpdateRequest
nameserversUpdateRequest
{
  "vanity_set_id": 1
}

Fields

Name
Type
Format
Required
Description
vanity_set_id
integer
-
Required
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.

Request example

PUT
curl --request PUT \
  --url 'https://api.regfish.com/domains/www.example.com/nameservers' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --data '{
  "vanity_set_id": 1
}'

Responses

200
Delegation after the change
application/jsonnameserversResponse
Response example 200
{
  "success": true,
  "code": 0,
  "response": {
    "domain": "example",
    "mode": "standard",
    "current": [
      "example"
    ],
    "vanity_set_id": 1,
    "vanity_sets": [
      {
        "id": 1,
        "host": "example",
        "nameservers": [
          null
        ]
      }
    ]
  }
}
401
Unauthorized
application/jsonError
Response example 401
{
  "success": false,
  "message": "Unauthorized",
  "error": "Unauthorized"
}
403
Blocked by the Domain-Guardian
application/jsonError
Response example 403
{
  "success": false,
  "message": "Blocked by the Domain-Guardian",
  "error": "Blocked by the Domain-Guardian"
}
404
Domain or vanity set not found
application/jsonError
Response example 404
{
  "success": false,
  "message": "Domain or vanity set not found",
  "error": "Domain or vanity set not found"
}
409
Domain state or plan does not allow the change
application/jsonError
Response example 409
{
  "success": false,
  "message": "Domain state or plan does not allow the change",
  "error": "Domain state or plan does not allow the change"
}
429
Daily change limit reached
application/jsonError
Response example 429
{
  "success": false,
  "message": "Daily change limit reached",
  "error": "Daily change limit reached"
}
500
Unexpected error
application/jsonError
Response example 500
{
  "success": false,
  "message": "Unexpected error",
  "error": "Unexpected error"
}
Community

Forma parte de la comunidad

La DNS API de Regfish es una gran solucion para desarrolladores que quieren automatizar dominios y zonas DNS. Sumate a la comunidad y aprovecha las ventajas de la automatizacion DNS. La DNS API esta disponible gratis para todos los clientes de Regfish.