Skip to content

MCP for AI agents30 toolsYour AI agent works with the rights you give it. Registering, transferring and cancelling stay in the customer area. If you give it the right, it can retrieve the transfer code of a domain: at most 3 retrievals per domain and day, and every retrieval is logged.

Read the MCP docs
DNS automation
v1.6.2
Download OpenAPI
YAMLJSON

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 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.
PUT
/domains/{domain}/nameservers
Domains

Authentication

x-api-keyapplication/json
Getting startedAuthenticationCustomer areaCreate an API key in the regfish console and test it

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

Become part of the community

The regfish DNS API is a great solution for developers who want to automate domains and DNS zones. Become part of the community and benefit from DNS automation. The DNS API is available free of charge to every regfish customer.

More free features