Change hostname for your VPS or domain

Update the hostname for a specific virtual server (VM) or an associated domain. A service restart may be required for changes to take full effect. Returns a unique ID to track the operation in subsequent calls.

Path Parameters

vmid integer · min: 1 required Example

Unique vmid identifier

Headers

Accept Example

Content-Type Example

Body

required

application/json

hostname string required

Responses

200

success boolean

timestamp string

requestId string

data object

400

error string

message string

code string

timestamp string

requestId string

401

error string

message string

code string

timestamp string

requestId string

429

error string

message string

retryAfter string

requestId string

POST https://cloud.hostup.se/api/vm/{vmid}/hostname

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/vm/17705/hostname" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hostname": "string"
  }'

Response

{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "success": true,
    "message": "string",
    "hostname": "string",
    "normalized": true,
    "hostbillSynced": true,
    "rdnsProtection": {
      "monitoredIps": 0,
      "changesDetected": 0,
      "restoredIps": [
        "string"
      ],
      "failedIps": [
        "string"
      ],
      "changedRecords": [
        "string"
      ]
    }
  }
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "message": {
          "type": "string"
        },
        "hostname": {
          "type": "string"
        },
        "normalized": {
          "type": "boolean"
        },
        "hostbillSynced": {
          "type": "boolean"
        },
        "rdnsProtection": {
          "type": "object",
          "properties": {
            "monitoredIps": {
              "type": "integer"
            },
            "changesDetected": {
              "type": "integer"
            },
            "restoredIps": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "failedIps": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "changedRecords": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      }
    }
  }
}

Request Body

{
  "hostname": "string"
}