Update domain nameservers and IP addresses

Change the nameservers associated with your domain. This is necessary when moving a domain to a new provider or configuring specific DNS settings. The process includes a pre-check to ensure the DNS zone is ready before the change is sent to the registry.

Domain Services Nameservers

Context

Used in the dashboard

/domains/bulk-nameservers

Where to get IDs / values

Path Parameters

domainId integer · min: 1 required Example: 19910

Unique domain identifier

Headers

Accept Example
Content-Type Example

Body

required
application/json
nameservers array required · Example: ["example.com","example.com"]
nsips array · Example: ["2001:db8::1","2001:db8::1"]

Responses

200
data object required
data.domainStatus string required · Example: Active
data.message string required · Example: Nameservers updated successfully

Human-readable message.

data.success boolean required · Example: true

True for successful responses.

data.syncTriggered boolean required · Example: false
requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

400
code string required · Example: BAD_REQUEST

Machine-readable error code.

details array<string> · Example: ["Module (iis_se): 2004: Parameter value range error - Cannot be used for zone signing."]

Optional validation details (field-level errors).

domainStatus string · Example: Active

Shows the current status of the domain after the operation.

error string required · Example: Bad Request

HTTP status title (e.g. 'Bad Request').

message string required · Example: Failed to update nameservers

Human-readable message.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

syncTriggered boolean · Example: true

Indicates if a synchronization has been initiated.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

401
code string required · Example: UNAUTHORIZED

Machine-readable error code.

error string required · Example: Unauthorized

HTTP status title (e.g. 'Bad Request').

message string required · Example: Authentication required

Human-readable message.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

POST https://cloud.hostup.se/api/domains/{domainId}/nameservers
For AI assistants
cURL 
curl -X POST "https://cloud.hostup.se/api/domains/19910/nameservers" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "nameservers": [
      "example.com",
      "example.com",
      {
        "_truncated": "... and 2 more items"
      }
    ],
    "nsips": [
      "2001:db8::1",
      "2001:db8::1",
      {
        "_truncated": "... and 2 more items"
      }
    ]
  }'
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "message": "Nameservers updated successfully",
    "success": true,
    "syncTriggered": false,
    "domainStatus": "Active"
  }
}
Request Body Example 1 
{
  "nameservers": [
    "example.com",
    "example.com",
    {
      "_truncated": "... and 2 more items"
    }
  ],
  "nsips": [
    "2001:db8::1",
    "2001:db8::1",
    {
      "_truncated": "... and 2 more items"
    }
  ]
}