Check and manage VPS maintenance

Check if there is any scheduled maintenance for a specific virtual server (VPS). If maintenance is scheduled, information is returned, including a `deadlineId` used to call POST /api/vm/{vmid}/maintenance/extend to postpone it.

VPS Services VM

Context

Where to get IDs / values

Workflow links

Produces

Path Parameters

vmid integer · min: 1 required Example: 10000

Unique vmid identifier

Headers

Accept Example
Content-Type Example

Responses

200
data object required
data.hasPendingMaintenance boolean required · Example: true
data.pendingChanges array<object> required · Example: [{"key":"cpu","currentValue":"custom-hostup-milan","pendingValue":"x86-64-v3","deadline...
data.pendingChanges[].canExtend boolean required · Example: true
data.pendingChanges[].currentValue string required · Example: custom-hostup-milan
data.pendingChanges[].deadline object · nullable required

Nullable: may be null when not applicable.

data.pendingChanges[].deadline.deadline_date string required · Example: 2026-02-10T00:00:00.000Z
data.pendingChanges[].deadline.description string required · Example: Change CPU type (same hardware) to allow for easy live-migrate to next-gen hardware in ...
data.pendingChanges[].deadline.extension_days integer required · Example: 7
data.pendingChanges[].deadline.id integer required · Example: 2
data.pendingChanges[].deadline.max_extensions integer required · Example: 2
data.pendingChanges[].deadline.pending_value string required · Example: x86-64-v3
data.pendingChanges[].deadline.task_type string required · Example: cpu
data.pendingChanges[].effectiveDeadline string · nullable required · Example: 2026-02-10T00:00:00.000Z

Nullable: may be null when not applicable.

data.pendingChanges[].extension object · nullable required

Nullable: may be null when not applicable.

data.pendingChanges[].extension.extended_deadline string required · Example: 2026-02-10T00:00:00.000Z
data.pendingChanges[].extension.extension_count integer required · Example: 1
data.pendingChanges[].extension.id integer required · Example: 1
data.pendingChanges[].extension.original_deadline string required · Example: 2026-02-10T00:00:00.000Z
data.pendingChanges[].extension.requested_at string required · Example: 2026-02-10T00:00:00.000Z
data.pendingChanges[].key string required · Example: cpu
data.pendingChanges[].pendingValue string required · Example: x86-64-v3
data.proxmoxVmId string · Example: 11259
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).

500
code string required · Example: INTERNAL_ERROR

Machine-readable error code.

error string required · Example: Internal Server Error

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

message string required · Example: An unexpected error occurred

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).

GET https://cloud.hostup.se/api/vm/{vmid}/maintenance
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/vm/10000/maintenance" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "hasPendingMaintenance": true,
    "pendingChanges": [
      {
        "key": "cpu",
        "currentValue": "custom-hostup-milan",
        "pendingValue": "x86-64-v3",
        "deadline": {
          "id": 2,
          "task_type": "cpu",
          "pending_value": "x86-64-v3",
          "deadline_date": "2026-02-10T00:00:00.000Z",
          "description": "Change CPU type (same hardware) to allow for easy live-migrate to next-gen hardware in future",
          "extension_days": 7,
          "max_extensions": 2
        },
        "extension": {
          "id": 1,
          "original_deadline": "2026-02-10T00:00:00.000Z",
          "extended_deadline": "2026-02-10T00:00:00.000Z",
          "extension_count": 1,
          "requested_at": "2026-02-10T00:00:00.000Z"
        },
        "effectiveDeadline": "2026-02-10T00:00:00.000Z",
        "canExtend": true
      }
    ],
    "proxmoxVmId": "11259"
  }
}