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
idstringrequiredvps_…).Example
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.
{ "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
vpsIdstringavailablebooleantrue when you can call POST /api/v2/vps/{id}/actions/convert-to-cloud now.reasonstring or nullnull when it is available.currentBillingModelstringfixed for a regular VPS. payg when it is already a Cloud VPS. One of fixed, payg.requiresVerificationbooleantrue when the account must be verified or get Cloud VPS access first.actionsobjectcanConvertToCloudobjectavailable and reason.allowedbooleanreasonstring or nullblockerReasonsarray of stringcurrentProductNamestring or nullscheduledChangenullnull when nothing is scheduled.prepaidWarningobject or nullnull when no paid period remains.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. |