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
idstringrequiredThe VPS ID (
vps_…).Example
curl "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/maintenance" \ -H "Authorization: Bearer $HOSTUP_API_KEY"Responses
200 Pending maintenance of the VPS.
{ "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
hasPendingMaintenancebooleanTrue when at least one change waits for a restart.
pendingChangesarray of objectChanges that apply at the next restart. Empty when there are none.
keystringThe setting that changes, for example
cpu.currentValuestring or nullThe value that applies now.
pendingValuestring or nullThe value after the restart.
deadlineobject | nullThe restart deadline for this change. Null when there is no deadline.
idstringThe deadline ID (
mtd_…). Send it as deadlineId to extend.descriptionstring or nullWhy the change is made.
deadlineAtstring or nullThe original deadline.
extensionDaysintegerDays one extension adds.
maxExtensionsintegerHow many times the deadline can be extended.
extensionobject | nullThe latest extension. Null when the deadline was never extended.
originalDeadlineAtstring or nullThe original deadline.
extendedDeadlineAtstring or nullThe deadline after the latest extension.
extensionCountintegerExtensions used so far.
requestedAtstring or nullWhen the latest extension was made.
effectiveDeadlineAtstring or nullThe deadline that applies now, extended or not. Null without a deadline.
canExtendbooleanTrue 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.
| 400 | Invalid request. The response body is an RFC 7807 Problem Details document. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The caller lacks a required scope or does not own the resource. |
| 404 | Not found. The resource does not exist or is not owned by the caller; code is vps_not_found. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |