Change VPS resources
POST /api/v2/vps/{id}/actions/config
Change the resources of a VPS without changing its plan: bandwidth, the primary disk, attachable storage, snapshot and backup slots, IPv4 addresses and IPv6. Read the options and their limits first with GET /api/v2/vps/{id}/actions/upgrade. Send the new values under resources with the keys from configurableOptions[].key, for example {"bandwidthGb": 4096}. storageGb is the primary disk. additionalStorageGb is attachable storage for extra disks. Send dryRun: true to see the price before you commit. To change plan, use POST /api/v2/vps/{id}/actions/upgrade. To change the billing cycle, use POST /api/v2/vps/{id}/actions/billing-cycle. billingCycle works here only together with dryRun: true. On a Cloud VPS only IPv4 and IPv6 change here. Other keys return 400.
Increases. When they cost money, primary-storage, snapshot, and backup increases create a separate prorated invoice for the rest of the paid period. They take effect when that invoice is paid. After that, an already-issued renewal invoice is repaired so it matches the new price. Snapshot and backup slots that cost nothing apply at once without an invoice. Bandwidth is prepaid for the current traffic period. Bandwidth-only increases end at the next monthly bandwidth reset. paymentInvoice.servicePeriodEndAt is that date. After it, the higher limit stays and is billed with each renewal. With oneTime: true the limit goes back at the reset instead. Nothing is then added to renewals. IP, plan, and billing-cycle changes are not routed through this separate invoice.
Decreases. A lower value takes effect at the next renewal. You keep the current capacity until scheduledChange.effectiveAt. There is no refund for the running period. The response has status: "scheduled". While a decrease is scheduled, only a one-time bandwidth increase is accepted. Other changes return 409 scheduled_change_in_progress. Cancel a scheduled decrease with DELETE /api/v2/vps/{id}/actions/upgrade. The primary disk cannot be made smaller.
Send increases and decreases in separate requests. Send IPv6 changes on their own. A request for the values the VPS already has returns status: "applied" without an invoice. If a response has invoiceLookupPending: true, do not retry the resource change. Wait until the renewal invoice appears before you send another change.
Authentication: An API key with one of these scopes: write:billing, write:vm. About keys and scopes
Request
Path parameters
idstringrequiredvps_…).Body
resourcesobjectrequiredconfigurableOptions[].key from GET /api/v2/vps/{id}/actions/upgrade. Common keys: bandwidthGb, storageGb (primary disk), additionalStorageGb (attachable storage), backupSlots, snapshotSlots, ipv4Count and ipv6.billingCyclestringdryRun: true. One of monthly, quarterly, semiannually, annually, biennially, triennially.dryRunbooleanfalse.cancelExistingInvoiceboolean409 existing_invoice_blocking suggests it. Default false.oneTimebooleanfalse.Example
curl -X POST "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/actions/config" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "resources": { "bandwidthGb": 4096 }, "dryRun": true }'curl -X POST "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/actions/config" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "resources": { "storageGb": 150 }, "dryRun": true }'curl -X POST "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/actions/config" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "resources": { "bandwidthGb": 4096 } }'curl -X POST "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/actions/config" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "resources": { "bandwidthGb": 4096 }, "oneTime": true }'curl -X POST "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/actions/config" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "resources": { "additionalStorageGb": 200 }, "dryRun": true }'curl -X POST "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/actions/config" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "resources": { "additionalStorageGb": 200 } }'curl -X POST "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/actions/config" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "resources": { "snapshotSlots": 3 }, "dryRun": true }'curl -X POST "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/actions/config" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "resources": { "snapshotSlots": 3 } }'curl -X POST "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/actions/config" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "resources": { "bandwidthGb": 2048 }, "dryRun": true }'curl -X POST "https://cloud.hostup.se/api/v2/vps/vps_01hxa3b4c5d6e7f8g9h0j1k2m3/actions/config" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "resources": { "bandwidthGb": 2048 } }'Responses
200 The preview or the result of the change.
{ "dryRun": true, "status": "preview", "changeKind": "configuration", "paymentInvoice": { "amount": 12.99, "currencyCode": "EUR", "servicePeriodEndAt": "2026-05-27T00:00:00.000Z", "paymentMethods": { "card": { "method": "card", "label": "Card", "available": true, "reason": null, "checkoutMode": "payment", "requirements": { "minimumAmount": { "amount": 0.5, "currencyCode": "EUR", "comparison": "greater_than" } } }, "accountCredit": { "method": "accountCredit", "label": "Account credit", "available": false, "reason": "No account credit is available.", "checkoutMode": null, "requirements": { "accountCurrencyCode": "EUR", "invoiceCurrencyCode": "EUR", "availableBalance": { "amount": 0, "currencyCode": "EUR" }, "maximumAmount": { "amount": 0, "currencyCode": "EUR", "comparison": "less_than_or_equal" } } }, "swish": { "method": "swish", "label": "Swish", "available": false, "reason": "Swish is only available for SEK invoices. This invoice is EUR.", "checkoutMode": null, "requirements": { "accountCountryCode": "SE", "invoiceCurrencyCode": "SEK" } }, "bankgiro": { "method": "bankgiro", "label": "Bankgiro", "available": false, "reason": "Bankgiro is only available for SEK invoices. This invoice is EUR.", "checkoutMode": null, "requirements": { "accountCountryCode": "SE", "invoiceCurrencyCode": "SEK" } }, "sepa": { "method": "sepa", "label": "SEPA bank transfer", "available": true, "reason": null, "checkoutMode": "sepa_bank_transfer_payment", "requirements": { "invoiceCurrencyCode": "EUR" } }, "alipay": { "method": "alipay", "label": "Alipay", "available": true, "reason": null, "checkoutMode": "alipay_payment", "requirements": { "invoiceCurrencyCodes": [ "EUR", "USD" ] } } }, "availablePaymentMethods": [ "card", "sepa", "alipay" ], "actions": { "canPayWithAvailableMethod": { "allowed": true, "reason": null } } }, "renewalInvoice": { "amount": 55, "currencyCode": "EUR" }, "warnings": [ { "code": "unused_prepaid_bandwidth_credited_after_period", "severity": "info", "reason": "Unused prepaid bandwidth is credited after the current service period ends." } ], "actions": { "canCommit": { "allowed": true, "reason": null } }}{ "dryRun": true, "status": "preview", "changeKind": "configuration", "scheduled": true, "paymentInvoice": null, "renewalInvoice": { "amount": 39, "currencyCode": "SEK" }, "warnings": [], "scheduledChange": { "status": "preview", "effectiveAt": "2026-08-01T22:05:00.000Z", "invoiceIssueAt": "2026-07-18T22:05:00.000Z", "target": { "resources": { "bandwidthGb": 2048 }, "billing": { "amount": 39, "currencyCode": "SEK", "billingCycle": "monthly" } }, "actions": { "canCancel": { "allowed": false, "reason": "No change has been scheduled yet." } } }, "actions": { "canCommit": { "allowed": true, "reason": null } }}{ "status": "awaiting_payment", "changeKind": "configuration", "paymentInvoice": { "id": "inv_01hxa3b4c5d6e7f8g9h0j1k2m3", "number": null, "amount": 12.99, "currencyCode": "EUR", "dueAt": "2026-04-27T12:34:56.000Z", "status": "unpaid", "paymentUrl": "/billing?invoice=10001" }, "renewalInvoice": null}{ "status": "processing", "changeKind": "configuration", "paymentInvoice": null, "renewalInvoice": null, "invoiceLookupPending": true}{ "status": "applied", "changeKind": "configuration", "paymentInvoice": null, "renewalInvoice": null}{ "status": "scheduled", "changeKind": "configuration", "scheduled": true, "scheduledChange": { "status": "scheduled", "effectiveAt": "2026-08-11T00:00:00.000Z", "invoiceIssueAt": "2026-07-28T00:00:00.000Z", "target": { "resources": { "bandwidthGb": 2048 }, "billing": { "amount": 39, "currencyCode": "SEK", "billingCycle": "monthly" } }, "actions": { "canCancel": { "allowed": true, "reason": null } } }, "paymentInvoice": null, "renewalInvoice": null}Response fields
billingModelstringprepaid_bandwidth when the change buys extra bandwidth paid in advance. Absent otherwise. One of prepaid_bandwidth.unusedBandwidthCreditEligibleboolean or nulldryRunbooleantrue.statusstringpreview.changeKindstringconfiguration.paymentInvoicenullrenewalInvoiceobjectamountnumbercurrencyCodestringservicePeriodEndAtstring or nullpaymentMethodsobjectcardobjectmethodstringpaymentMethods. Card checkout and wallets are all card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto.labelstringavailablebooleanvisiblebooleanreasonstring or nullavailable is false.checkoutModestring or nullpayment, sepa_bank_transfer_payment, alipay_payment.requirementsobjectinvoiceCurrencyCodestringinvoiceCurrencyCodesarray of stringaccountCountryCodestringaccountCountryExcludedCodestringaccountTypestringprivate, organisation.accountCurrencyCodestringrequiresCardVerificationbooleanavailableBalanceobjectamountnumbercurrencyCodestringminimumAmountobjectamountnumbercurrencyCodestringcomparisonstringamount. greater_than: more than it, used in minimumAmount. less_than_or_equal: at most it, used in maximumAmount. One of greater_than, less_than_or_equal.maximumAmountobjectamountnumbercurrencyCodestringcomparisonstringamount. greater_than: more than it, used in minimumAmount. less_than_or_equal: at most it, used in maximumAmount. One of greater_than, less_than_or_equal.accountCreditobjectmethodstringpaymentMethods. Card checkout and wallets are all card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto.labelstringavailablebooleanvisiblebooleanreasonstring or nullavailable is false.checkoutModestring or nullpayment, sepa_bank_transfer_payment, alipay_payment.requirementsobjectinvoiceCurrencyCodestringinvoiceCurrencyCodesarray of stringaccountCountryCodestringaccountCountryExcludedCodestringaccountTypestringprivate, organisation.accountCurrencyCodestringrequiresCardVerificationbooleanavailableBalanceobjectamountnumbercurrencyCodestringminimumAmountobjectamountnumbercurrencyCodestringcomparisonstringamount. greater_than: more than it, used in minimumAmount. less_than_or_equal: at most it, used in maximumAmount. One of greater_than, less_than_or_equal.maximumAmountobjectamountnumbercurrencyCodestringcomparisonstringamount. greater_than: more than it, used in minimumAmount. less_than_or_equal: at most it, used in maximumAmount. One of greater_than, less_than_or_equal.swishobjectmethodstringpaymentMethods. Card checkout and wallets are all card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto.labelstringavailablebooleanvisiblebooleanreasonstring or nullavailable is false.checkoutModestring or nullpayment, sepa_bank_transfer_payment, alipay_payment.requirementsobjectinvoiceCurrencyCodestringinvoiceCurrencyCodesarray of stringaccountCountryCodestringaccountCountryExcludedCodestringaccountTypestringprivate, organisation.accountCurrencyCodestringrequiresCardVerificationbooleanavailableBalanceobjectamountnumbercurrencyCodestringminimumAmountobjectamountnumbercurrencyCodestringcomparisonstringamount. greater_than: more than it, used in minimumAmount. less_than_or_equal: at most it, used in maximumAmount. One of greater_than, less_than_or_equal.maximumAmountobjectamountnumbercurrencyCodestringcomparisonstringamount. greater_than: more than it, used in minimumAmount. less_than_or_equal: at most it, used in maximumAmount. One of greater_than, less_than_or_equal.bankgiroobjectmethodstringpaymentMethods. Card checkout and wallets are all card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto.labelstringavailablebooleanvisiblebooleanreasonstring or nullavailable is false.checkoutModestring or nullpayment, sepa_bank_transfer_payment, alipay_payment.requirementsobjectinvoiceCurrencyCodestringinvoiceCurrencyCodesarray of stringaccountCountryCodestringaccountCountryExcludedCodestringaccountTypestringprivate, organisation.accountCurrencyCodestringrequiresCardVerificationbooleanavailableBalanceobjectamountnumbercurrencyCodestringminimumAmountobjectamountnumbercurrencyCodestringcomparisonstringamount. greater_than: more than it, used in minimumAmount. less_than_or_equal: at most it, used in maximumAmount. One of greater_than, less_than_or_equal.maximumAmountobjectamountnumbercurrencyCodestringcomparisonstringamount. greater_than: more than it, used in minimumAmount. less_than_or_equal: at most it, used in maximumAmount. One of greater_than, less_than_or_equal.sepaobjectmethodstringpaymentMethods. Card checkout and wallets are all card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto.labelstringavailablebooleanvisiblebooleanreasonstring or nullavailable is false.checkoutModestring or nullpayment, sepa_bank_transfer_payment, alipay_payment.requirementsobjectinvoiceCurrencyCodestringinvoiceCurrencyCodesarray of stringaccountCountryCodestringaccountCountryExcludedCodestringaccountTypestringprivate, organisation.accountCurrencyCodestringrequiresCardVerificationbooleanavailableBalanceobjectamountnumbercurrencyCodestringminimumAmountobjectamountnumbercurrencyCodestringcomparisonstringamount. greater_than: more than it, used in minimumAmount. less_than_or_equal: at most it, used in maximumAmount. One of greater_than, less_than_or_equal.maximumAmountobjectamountnumbercurrencyCodestringcomparisonstringamount. greater_than: more than it, used in minimumAmount. less_than_or_equal: at most it, used in maximumAmount. One of greater_than, less_than_or_equal.alipayobjectmethodstringpaymentMethods. Card checkout and wallets are all card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto.labelstringavailablebooleanvisiblebooleanreasonstring or nullavailable is false.checkoutModestring or nullpayment, sepa_bank_transfer_payment, alipay_payment.requirementsobjectinvoiceCurrencyCodestringinvoiceCurrencyCodesarray of stringaccountCountryCodestringaccountCountryExcludedCodestringaccountTypestringprivate, organisation.accountCurrencyCodestringrequiresCardVerificationbooleanavailableBalanceobjectamountnumbercurrencyCodestringminimumAmountobjectamountnumbercurrencyCodestringcomparisonstringamount. greater_than: more than it, used in minimumAmount. less_than_or_equal: at most it, used in maximumAmount. One of greater_than, less_than_or_equal.maximumAmountobjectamountnumbercurrencyCodestringcomparisonstringamount. greater_than: more than it, used in minimumAmount. less_than_or_equal: at most it, used in maximumAmount. One of greater_than, less_than_or_equal.cryptoobjectmethodstringpaymentMethods. Card checkout and wallets are all card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto.labelstringavailablebooleanvisiblebooleanreasonstring or nullavailable is false.checkoutModestring or nullpayment, sepa_bank_transfer_payment, alipay_payment.requirementsobjectinvoiceCurrencyCodestringinvoiceCurrencyCodesarray of stringaccountCountryCodestringaccountCountryExcludedCodestringaccountTypestringprivate, organisation.accountCurrencyCodestringrequiresCardVerificationbooleanavailableBalanceobjectamountnumbercurrencyCodestringminimumAmountobjectamountnumbercurrencyCodestringcomparisonstringamount. greater_than: more than it, used in minimumAmount. less_than_or_equal: at most it, used in maximumAmount. One of greater_than, less_than_or_equal.maximumAmountobjectamountnumbercurrencyCodestringcomparisonstringamount. greater_than: more than it, used in minimumAmount. less_than_or_equal: at most it, used in maximumAmount. One of greater_than, less_than_or_equal.availablePaymentMethodsarray of stringactionsobjectcanPayWithAvailableMethodobjectallowedbooleanreasonstring or nullallowed is true.warningsarray of objectcodestringunused_prepaid_bandwidth_credited_after_period.severitystringinfo.reasonstringscheduledbooleanscheduledChangeobjectstatusstringpreview, scheduled, awaiting_payment, paid, applying, applied, needs_attention, cancelling, cancelled.effectiveAtstring or nullinvoiceIssueAtstring or nulltargetobjectproductSlugstringresourcesobjectstorageGb can be larger than the new plan’s disk. The primary disk cannot be made smaller.billingobjectamountnumber or nullcurrencyCodestringbillingCyclestringmonthly, quarterly, semiannually, annually, biennially, triennially, free.actionsobjectcanCancelobjectallowedbooleanreasonstring or nullallowed is true.actionsobjectcanCommitobjectallowedbooleanreasonstring or nullallowed is true.Errors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | The body is invalid. errors[].code says why. mixed_effective_dates: the body mixes changes that must be sent separately. unsupported_payg_config_resource: the resource cannot change here on a Cloud VPS. |
| 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. |
| 409 | The change is blocked. existing_invoice_blocking: an unpaid invoice must be paid or cancelled first. payment_method_unavailable: no payment method can pay the new invoice. scheduled_change_in_progress: a scheduled change must finish or be cancelled first. service_change_in_progress and billing_change_busy: another change is running. Try again shortly. scheduled_change_processing_unavailable: scheduled changes are unavailable right now. Try again later. resource_in_use: storage is still in use and the lower limit cannot apply. renewal_period_review_required: the renewal periods need a check by support. paused_under_attack: the VPS was recently the target of a DDoS attack. More ipv4Count is refused until pausedUnderAttackUntil. Other resources can still change. |
| 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. |
| 502 | Billing data the change depends on could not be read or updated, such as currency, tax, prices, usage or the renewal. Try again shortly. |