Update nameservers for a domain

APIs & SDKs

PATCHhttps://api.vercel.com/v1/registrar/domains/{domain}/nameservers

Update the nameservers for a domain. Pass an empty array to use Vercel's default nameservers.

https://api.vercel.com/v1/registrar/domains/{domain}/nameservers

const response = await fetch('https://api.vercel.com/v1/registrar/domains/domain/nameservers?teamId=string', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "nameservers": []
  }),
});

const data = await response.json();
console.log(data);

Response

{}

Errors

{
  "status": "400",
  "code": "domain_not_registered",
  "message": "string"
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

domainanyRequired

Query parameters

teamIdstringOptional

Body

application/json

nameserversarrayRequired

Response

204Success

Errors

400There was something wrong with the request

statusnumberRequired

codestringRequired

messagestringRequired

401Unauthorized

statusnumberRequired

codestringRequired

messagestringRequired

reasonstringOptional

403Forbidden

statusnumberRequired

codestringRequired

messagestringRequired

404The domain was not found in our system.

statusnumberRequired

codestringRequired

messagestringRequired

429TooManyRequests

statusnumberRequired

codestringRequired

messagestringRequired

retryAfterobjectRequired

limitobjectRequired

500InternalServerError

statusnumberRequired

codestringRequired

messagestringRequired

Cross-link map: Update nameservers for a domain (/docs/rest-api/domains-registrar/update-nameservers-for-a-domain)

From the Vercel docs graph (built 2026-10-14T10:24:21.026Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.json

Semantically closest pages

Update auto-renew for a domain — PATCH /v1/registrar/domains/{domain}/auto-renew — Update the auto-renew setting for a domain
Renew a domain — POST /v1/registrar/domains/{domain}/renew — Renew a domain
Get Domain Availability and Pricing — POST /v1/registrar/domains/search — Start domain research here. Get registration availability and pricing for 1–200 exac
Get a domain's transfer status — GET /v1/registrar/domains/{domain}/transfer — Get the transfer status for a domain
Update or move apex domain — PATCH /v3/domains/{domain} — Update or move apex domain. Note: This endpoint is no longer used for updating auto-renew o

This page links to (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

Pages that link here (2)

By site: vercel-docs (2)

Programmatic Domain Management — Programmatically search, price, purchase, renew, and manage domains with Vercel's domains registrar API endpoints.
Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

https://api.vercel.com/v1/registrar/domains/{domain}/nameservers

const response = await fetch('https://api.vercel.com/v1/registrar/domains/domain/nameservers?teamId=string', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "nameservers": []
  }),
});

const data = await response.json();
console.log(data);

Response

{}

Errors

{
  "status": "400",
  "code": "domain_not_registered",
  "message": "string"
}

OpenAPI Specification