---
title: "Change domain name servers"
method: PUT
path: "/{account}/registrar/domains/{domain}/delegation"
tags: ["registrar delegation"]
---

# Change domain name servers

`PUT /{account}/registrar/domains/{domain}/delegation`

## Request

- Base URL: `https://api.dnsimple.com/v2`
- URL: `https://api.dnsimple.com/v2/{account}/registrar/domains/{domain}/delegation`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/dnsimple/apis/dnsimple-api/docs/:account/registrar/domains/:domain/delegation/put.ts> (a function with typed inputs; its response is checked against the schema)

Changes the domain name servers.

Both the canonical dnsimple-edge hostnames and the legacy ns1.dnsimple.com through ns4.dnsimple.com hostnames are accepted. New delegations should use the canonical hostnames.

## Path parameters

- `account` integer, required
- `domain` string, required

## Request body

- string[]

## Response `200`

Successfully updated the domain name servers.

- object
  - `data` DomainNameServer[]

## Other responses

- `400`: A required parameter is missing or the request is invalid.
- `404`: The requested resource doesn't exist.

## Changes

- **2025-07-11** (v2) `06780be0ef17`: 3 info
  - the response property `errors` became required for the status `400`
  - the response property `message` became required for the status `400`
  - the response property `message` became required for the status `404`
- **2023-07-18** (v2) `c8591dcf8c29`: 3 breaking
  - the response property `errors` became optional for the status `400`
  - the response property `message` became optional for the status `400`
  - the response property `message` became optional for the status `404`

[Operation history](https://skmtc.dev/dnsimple/apis/dnsimple-api/changes/:account/registrar/domains/:domain/delegation/put.md)

---

[API](https://skmtc.dev/dnsimple/apis/dnsimple-api.md) - [All operations](https://skmtc.dev/dnsimple/apis/dnsimple-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dnsimple/apis/dnsimple-api/revisions/2d2e7a8fb60a?raw)