Skip to content

List pending maintenance of a VPS

GET /api/v2/vps/{id}/maintenance

Lists settings of the VPS that change at its next restart, such as a new CPU type. It also gives the date by which Hostup asks you to restart. Restart the VPS with POST /api/v2/vps/{id}/actions/restart to apply them. A restart from inside the operating system is not enough. When canExtend is true, move the date with POST /api/v2/vps/{id}/maintenance/actions/extend. Send deadline.id as deadlineId.

Authentication: An API key with the scope read:vm. About keys and scopes

Request

Path parameters

idstringrequired
The VPS ID (vps_…).

Example

GET /api/v2/vps/{id}/maintenance
curl "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/maintenance" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

200 Pending maintenance of the VPS.

Response 200
{
"hasPendingMaintenance": true,
"pendingChanges": [
{
"key": "cpu",
"currentValue": "kvm64",
"pendingValue": "x86-64-v2-AES",
"deadline": {
"id": "mtd_01hxa3b4c5d6e7f8g9h0j1k2m3",
"description": "New CPU type for better compatibility.",
"deadlineAt": "2026-11-15T00:00:00.000Z",
"extensionDays": 7,
"maxExtensions": 2
},
"extension": null,
"effectiveDeadlineAt": "2026-11-15T00:00:00.000Z",
"canExtend": true
}
]
}
Response fields
hasPendingMaintenanceboolean
True when at least one change waits for a restart.
pendingChangesarray of object
Changes that apply at the next restart. Empty when there are none.
keystring
The setting that changes, for example cpu.
currentValuestring or null
The value that applies now.
pendingValuestring or null
The value after the restart.
deadlineobject | null
The restart deadline for this change. Null when there is no deadline.
idstring
The deadline ID (mtd_…). Send it as deadlineId to extend.
descriptionstring or null
Why the change is made.
deadlineAtstring or null
The original deadline.
extensionDaysinteger
Days one extension adds.
maxExtensionsinteger
How many times the deadline can be extended.
extensionobject | null
The latest extension. Null when the deadline was never extended.
originalDeadlineAtstring or null
The original deadline.
extendedDeadlineAtstring or null
The deadline after the latest extension.
extensionCountinteger
Extensions used so far.
requestedAtstring or null
When the latest extension was made.
effectiveDeadlineAtstring or null
The deadline that applies now, extended or not. Null without a deadline.
canExtendboolean
True when the deadline can be extended once more.

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Unauthorized. Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
404Not found. The resource does not exist or is not owned by the caller; code is vps_not_found.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.