regfish
Domains, DNS, hosting and email from a single source.
Free DNS tools
Check SPF, DMARC, DNSSEC and more at dns-doctor.com
Resources & Support
Direct member of
© 2002-2026 regfish GmbH. All rights reserved.
PUT
/domains/{domain}/nameservers
Domains
Authentication
Parameters
Name
Type
Format
Required
Description
domain
string
-
Required
Fully Qualified Domain Name.
Request body
No description was provided in the specification.
nameserversUpdateRequestnameserversUpdateRequest
{
"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
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
Response example 401
{
"success": false,
"message": "Unauthorized",
"error": "Unauthorized"
}403
Blocked by the Domain-Guardian
Response example 403
{
"success": false,
"message": "Blocked by the Domain-Guardian",
"error": "Blocked by the Domain-Guardian"
}404
Domain or vanity set not found
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
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
Response example 429
{
"success": false,
"message": "Daily change limit reached",
"error": "Daily change limit reached"
}500
Unexpected error
Response example 500
{
"success": false,
"message": "Unexpected error",
"error": "Unexpected error"
}