Change your VPS or domain hostname

Modify the hostname for your virtual server (VPS) or a domain. This is useful for configuration or to establish a more specific identifier for your server or domain name.

VPS Services VM

Context

Used in the dashboard

/instance/[id]

Where to get IDs / values

path.vmid

GET /api/vps-accounts

Related endpoints

GET /api/vm/{vmid}/hostname Get your VM hostname GET /api/vm/{vmid}/iso Get available ISO images for a VM POST /api/vm/{vmid}/iso Mount an ISO file to a VPS for installation or troubleshooting

Path Parameters

vmid integer · min: 1 required Example: 10000

Unique vmid identifier

Headers

Accept Example

Content-Type Example

Body

required

application/json

hostname string required · Example: 01SE

Responses

200

data object required

data.hostbillSynced boolean required · Example: true

data.hostname string required · Example: example.com

data.message string required · Example: VM updated, reboot to apply changes Saved as example.com.

Human-readable message.

data.normalized boolean required · Example: true

data.rdnsProtection object required

data.rdnsProtection.changedRecords array<object> required · Example: [{"ip":"192.0.0.1","previous":"11237.hostup.se","current":"example.com"}]

data.rdnsProtection.changedRecords[].current string required · Example: example.com

data.rdnsProtection.changedRecords[].ip string required · Example: 192.0.0.1

data.rdnsProtection.changedRecords[].previous string required · Example: 11237.hostup.se

data.rdnsProtection.changesDetected integer required · Example: 0

data.rdnsProtection.failedIps array<object> required · Example: []

data.rdnsProtection.monitoredIps integer required · Example: 1

data.rdnsProtection.restoredIps array<string> required · Example: ["192.0.0.1"]

data.success boolean required · Example: true

True for successful responses.

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.

error string required · Example: Bad Request

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

message string required · Example: VM must be running to change hostname

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/vm/{vmid}/hostname

For AI assistants

cURL

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

Response

{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "success": true,
    "message": "VM updated, reboot to apply changes Saved as example.com.",
    "hostname": "example.com",
    "normalized": true,
    "hostbillSynced": true,
    "rdnsProtection": {
      "monitoredIps": 1,
      "changesDetected": 0,
      "restoredIps": [],
      "failedIps": [],
      "changedRecords": []
    }
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "hostbillSynced": {
          "type": "boolean"
        },
        "hostname": {
          "type": "string"
        },
        "message": {
          "type": "string",
          "description": "Human-readable message."
        },
        "normalized": {
          "type": "boolean"
        },
        "rdnsProtection": {
          "type": "object",
          "properties": {
            "changedRecords": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "current": {
                    "type": "string"
                  },
                  "ip": {
                    "type": "string"
                  },
                  "previous": {
                    "type": "string"
                  }
                }
              }
            },
            "changesDetected": {
              "type": "integer"
            },
            "failedIps": {
              "type": "array",
              "items": {
                "type": "object"
              }
            },
            "monitoredIps": {
              "type": "integer"
            },
            "restoredIps": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "success": {
          "type": "boolean",
          "description": "True for successful responses."
        }
      }
    },
    "requestId": {
      "type": "string",
      "description": "Unique request identifier (UUID)."
    },
    "success": {
      "type": "boolean",
      "description": "True for successful responses."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp (UTC)."
    }
  }
}

Request Body Example 1

{
  "hostname": "01SE"
}