Domain Nameservers2026.8.0

Update domain nameservers

Replaces the nameserver set for the domain with the provided list.

POST/api/v1/spaces/assets/domains/{domain}/nameservers

The source export uses a local development server. Examples use the configured Dashio API origin.

The export references authentication schemes without supplying their definitions.

Authentication

bearerAuth

Understand authentication

Path parameters

domainstringRequired: Domain name in FQDN format

Query parameters

None declared in this export.

Header parameters

None declared in this export.

Request body

application/json · Required

nameserversobject[]Required

No field description supplied.

Request & response examples

Copy an example in your preferred language.

request.sh

curl --request POST 'https://dashio.net/api/v1/spaces/assets/domains/{domain}/nameservers' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "nameservers": [
    {
      "name": "<name>"
    }
  ]
}'

Replace URL parameters, credentials, and schema placeholders before running. No request is sent by this page.

Schema-generated example; not a captured response.

{
  "success": false
}

Examples use the configured API origin. Replace credentials, URL parameters, and schema placeholders before running.

Responses

200

Nameservers updated.

successbooleanRequired: No field description supplied.

400

Invalid request.

No response body schema supplied.

404

Domain not found.

No response body schema supplied.

422

DNSSEC must be disabled before switching to external nameservers, or the registrar rejected the nameserver set.

errorbooleanRequired: Allowed values: true.
urlstringOptional: No field description supplied.
statusCodeintegerRequired: Allowed values: 422.
statusMessagestringRequired: No field description supplied.
messagestringRequired: No field description supplied.

500

Failed to update nameservers.

No response body schema supplied.

Was this helpful?

Update domain nameservers

Authentication

Path parameters

Query parameters

Header parameters

Cookie parameters

Request body

4 child fields

Responses

200

400

404

422

500