---
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`

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`

[Change 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/faec8b49cc03?raw)
