Delegate to vanity name servers

Changed on Jul 11, 2025

Delegate a domain to vanity name servers.

put/{account}/registrar/domains/{domain}/delegation/vanity

Request

Base URL
https://api.dnsimple.com/v2
Auth
- HTTP basic
- or HTTP bearer
TypeScript
https://skmtc.dev/dnsimple/apis/dnsimple-api/docs/:account/registrar/domains/:domain/delegation/vanity/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

accountinteger required

The account id

domainstring required

The domain name or id

Request body

string[] required

Example request

[
  "ns1.example.com",
  "ns2.example.com",
  "ns3.example.com",
  "ns4.example.com"
]

Response

Successfully delegated to vanity name servers.

Example response

{
  "data": [
    {
      "id": 1,
      "name": "ns1.example.com",
      "ipv4": "127.0.0.1",
      "ipv6": "::1",
      "created_at": "2016-07-11T09:40:19Z",
      "updated_at": "2016-07-11T09:40:19Z"
    }
  ]
}

Changes

Jul 11, 2025v206780be0ef17 Revision changes
- info
  the response property became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
Jul 18, 2023v2c8591dcf8c29 Revision changes
- breaking
  the response property became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property became optional for the status
- breaking
  the response property became optional for the status
- breaking
  the response property became optional for the status

Operation history