Skip to content

Check a switch to Cloud VPS (same IP, no restart)

GET /api/v2/vps/{id}/actions/convert-to-cloud

Check whether a VPS can switch to pay-as-you-go Cloud VPS billing. The switch takes effect at the end of the current paid period. It is a billing-only conversion. The VPS keeps its disks, network settings and primary public IP. It does not restart or interrupt the server. A later CPU or RAM resize is a separate change and may need a restart.

Call it before POST /api/v2/vps/{id}/actions/convert-to-cloud. When available is false, reason says why and blockerReasons lists every blocker. requiresVerification is true when the account must be verified or get Cloud VPS access first. The *_limit_exceeded blockers mean the VPS is bigger than the account’s Cloud VPS limits allow. A change that is already scheduled shows in scheduledChange and blocks the switch. Cancel it with DELETE /api/v2/vps/{id}/actions/upgrade. currentBillingModel: "payg" means the VPS is already a Cloud VPS.

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

Request

Path parameters

idstringrequired
The VPS ID (vps_…).

Example

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

Responses

200 Whether the VPS can switch to Cloud VPS.

Response 200
{
"vpsId": "vps_01hxa3b4c5d6e7f8g9h0j1k2m3",
"available": false,
"reason": "Account verification is required before converting to Cloud VM.",
"currentBillingModel": "fixed",
"requiresVerification": true,
"actions": {
"canConvertToCloud": {
"allowed": false,
"reason": "Account verification is required before converting to Cloud VM."
}
},
"blockerReasons": [
"not_verified",
"no_cloud_access"
],
"currentProductName": "VPS XS",
"scheduledChange": null,
"prepaidWarning": {
"nextDueAt": "2026-05-27T00:00:00.000Z",
"billingCycle": "monthly",
"daysRemaining": 18
}
}
Response fields
vpsIdstring
The VPS ID.
availableboolean
true when you can call POST /api/v2/vps/{id}/actions/convert-to-cloud now.
reasonstring or null
Why the switch is blocked. null when it is available.
currentBillingModelstring
fixed for a regular VPS. payg when it is already a Cloud VPS. One of fixed, payg.
requiresVerificationboolean
true when the account must be verified or get Cloud VPS access first.
actionsobject
canConvertToCloudobject
Same answer as available and reason.
allowedboolean
reasonstring or null
blockerReasonsarray of string
Every blocker as a code. Empty when the switch is available.
currentProductNamestring or null
Name of the VPS plan.
scheduledChangenull
A change already scheduled for this VPS. null when nothing is scheduled.
prepaidWarningobject or null
The paid period that runs before the switch. The switch waits for its end. Paid time is not refunded. null when no paid period remains.

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.