Update a domain's nameservers and initiate pre-checks

Change the nameservers associated with your domain. This is often necessary when migrating services or setting up new DNS configurations. The API returns a jobId to retrieve the pre-check results via a separate GET request.

Path Parameters

domainId integer · min: 1 required Example

Unique domain identifier

Headers

Accept Example

Content-Type Example

Body

required

application/json

nameservers array required

domainIds array

nsips array

Responses

200

success boolean

timestamp string

requestId string

data object

400

error string

message string

code string

timestamp string

requestId string

details array

syncTriggered boolean

domainStatus string

401

error string

message string

code string

timestamp string

requestId string

403

error string

message string

code string

timestamp string

requestId string

504

error string

message string

code string

timestamp string

requestId string

POST https://cloud.hostup.se/api/domains/{domainId}/nameservers

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/domains/369/nameservers" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "nameservers": [
      "string"
    ],
    "domainIds": [
      "string"
    ],
    "nsips": [
      "string"
    ]
  }'

Response

{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "message": "string",
    "success": true,
    "syncTriggered": true,
    "domainStatus": "string"
  }
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string"
        },
        "success": {
          "type": "boolean"
        },
        "syncTriggered": {
          "type": "boolean"
        },
        "domainStatus": {
          "type": "string"
        }
      }
    }
  }
}

Request Body

{
  "nameservers": [
    "string"
  ],
  "domainIds": [
    "string"
  ],
  "nsips": [
    "string"
  ]
}