Skip to content

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

idstringrequired
The VPS ID (vps_…).

Body

resourcesobjectrequired
The new values, keyed by configurableOptions[].key from GET /api/v2/vps/{id}/actions/upgrade. Common keys: bandwidthGb, storageGb (primary disk), additionalStorageGb (attachable storage), backupSlots, snapshotSlots, ipv4Count and ipv6.
billingCyclestring
Billing cycle to price the preview with. Only allowed with dryRun: true. One of monthly, quarterly, semiannually, annually, biennially, triennially.
dryRunboolean
Return the price without making the change. Default false.
cancelExistingInvoiceboolean
Cancel the unpaid invoice that blocks the change. Send it only after a 409 existing_invoice_blocking suggests it. Default false.
oneTimeboolean
Make a bandwidth-only increase apply to the current traffic period only. The limit goes back at the next bandwidth reset and nothing is added to renewals. Rejected on any other change. Default false.

Example

POST /api/v2/vps/{id}/actions/config
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
}'

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
}
}
}
Response fields
billingModelstring
prepaid_bandwidth when the change buys extra bandwidth paid in advance. Absent otherwise. One of prepaid_bandwidth.
unusedBandwidthCreditEligibleboolean or null
True when the unused part of the extra bandwidth is credited to the account balance after the period. False when it is not. Null when this could not be confirmed.
dryRunboolean
One of true.
statusstring
One of preview.
changeKindstring
One of configuration.
paymentInvoicenull
renewalInvoiceobject
amountnumber
currencyCodestring
servicePeriodEndAtstring or null
End of the period the immediate charge covers. For a bandwidth-only increase this is the next monthly bandwidth reset. For a prorated increase of a recurring resource it is the end of the current paid period. Absent when the preview is not a charge for the current period.
paymentMethodsobject
cardobject
methodstring
The payment method, the same as its key in paymentMethods. Card checkout and wallets are all card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto.
labelstring
The method’s name, for display.
availableboolean
visibleboolean
Present for restricted methods. When false, don’t show the method to the customer.
reasonstring or null
Why the method cannot be used, when available is false.
checkoutModestring or null
The kind of hosted checkout the payment session uses. Null for methods without a hosted checkout. One of payment, sepa_bank_transfer_payment, alipay_payment.
requirementsobject
What the payment method needs. Examples: a minimum amount for card, a Swedish account for Swish and bankgiro, EUR for a SEPA bank transfer, an eligible account for cryptocurrency, enough account credit.
invoiceCurrencyCodestring
invoiceCurrencyCodesarray of string
accountCountryCodestring
accountCountryExcludedCodestring
A billing country this method does not accept.
accountTypestring
One of private, organisation.
accountCurrencyCodestring
requiresCardVerificationboolean
Whether a saved card or an earlier successful card payment is needed.
availableBalanceobject
amountnumber
currencyCodestring
minimumAmountobject
amountnumber
currencyCodestring
comparisonstring
How the payment amount must compare with amount. 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.
maximumAmountobject
amountnumber
currencyCodestring
comparisonstring
How the payment amount must compare with amount. 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.
accountCreditobject
methodstring
The payment method, the same as its key in paymentMethods. Card checkout and wallets are all card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto.
labelstring
The method’s name, for display.
availableboolean
visibleboolean
Present for restricted methods. When false, don’t show the method to the customer.
reasonstring or null
Why the method cannot be used, when available is false.
checkoutModestring or null
The kind of hosted checkout the payment session uses. Null for methods without a hosted checkout. One of payment, sepa_bank_transfer_payment, alipay_payment.
requirementsobject
What the payment method needs. Examples: a minimum amount for card, a Swedish account for Swish and bankgiro, EUR for a SEPA bank transfer, an eligible account for cryptocurrency, enough account credit.
invoiceCurrencyCodestring
invoiceCurrencyCodesarray of string
accountCountryCodestring
accountCountryExcludedCodestring
A billing country this method does not accept.
accountTypestring
One of private, organisation.
accountCurrencyCodestring
requiresCardVerificationboolean
Whether a saved card or an earlier successful card payment is needed.
availableBalanceobject
amountnumber
currencyCodestring
minimumAmountobject
amountnumber
currencyCodestring
comparisonstring
How the payment amount must compare with amount. 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.
maximumAmountobject
amountnumber
currencyCodestring
comparisonstring
How the payment amount must compare with amount. 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.
swishobject
methodstring
The payment method, the same as its key in paymentMethods. Card checkout and wallets are all card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto.
labelstring
The method’s name, for display.
availableboolean
visibleboolean
Present for restricted methods. When false, don’t show the method to the customer.
reasonstring or null
Why the method cannot be used, when available is false.
checkoutModestring or null
The kind of hosted checkout the payment session uses. Null for methods without a hosted checkout. One of payment, sepa_bank_transfer_payment, alipay_payment.
requirementsobject
What the payment method needs. Examples: a minimum amount for card, a Swedish account for Swish and bankgiro, EUR for a SEPA bank transfer, an eligible account for cryptocurrency, enough account credit.
invoiceCurrencyCodestring
invoiceCurrencyCodesarray of string
accountCountryCodestring
accountCountryExcludedCodestring
A billing country this method does not accept.
accountTypestring
One of private, organisation.
accountCurrencyCodestring
requiresCardVerificationboolean
Whether a saved card or an earlier successful card payment is needed.
availableBalanceobject
amountnumber
currencyCodestring
minimumAmountobject
amountnumber
currencyCodestring
comparisonstring
How the payment amount must compare with amount. 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.
maximumAmountobject
amountnumber
currencyCodestring
comparisonstring
How the payment amount must compare with amount. 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.
bankgiroobject
methodstring
The payment method, the same as its key in paymentMethods. Card checkout and wallets are all card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto.
labelstring
The method’s name, for display.
availableboolean
visibleboolean
Present for restricted methods. When false, don’t show the method to the customer.
reasonstring or null
Why the method cannot be used, when available is false.
checkoutModestring or null
The kind of hosted checkout the payment session uses. Null for methods without a hosted checkout. One of payment, sepa_bank_transfer_payment, alipay_payment.
requirementsobject
What the payment method needs. Examples: a minimum amount for card, a Swedish account for Swish and bankgiro, EUR for a SEPA bank transfer, an eligible account for cryptocurrency, enough account credit.
invoiceCurrencyCodestring
invoiceCurrencyCodesarray of string
accountCountryCodestring
accountCountryExcludedCodestring
A billing country this method does not accept.
accountTypestring
One of private, organisation.
accountCurrencyCodestring
requiresCardVerificationboolean
Whether a saved card or an earlier successful card payment is needed.
availableBalanceobject
amountnumber
currencyCodestring
minimumAmountobject
amountnumber
currencyCodestring
comparisonstring
How the payment amount must compare with amount. 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.
maximumAmountobject
amountnumber
currencyCodestring
comparisonstring
How the payment amount must compare with amount. 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.
sepaobject
methodstring
The payment method, the same as its key in paymentMethods. Card checkout and wallets are all card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto.
labelstring
The method’s name, for display.
availableboolean
visibleboolean
Present for restricted methods. When false, don’t show the method to the customer.
reasonstring or null
Why the method cannot be used, when available is false.
checkoutModestring or null
The kind of hosted checkout the payment session uses. Null for methods without a hosted checkout. One of payment, sepa_bank_transfer_payment, alipay_payment.
requirementsobject
What the payment method needs. Examples: a minimum amount for card, a Swedish account for Swish and bankgiro, EUR for a SEPA bank transfer, an eligible account for cryptocurrency, enough account credit.
invoiceCurrencyCodestring
invoiceCurrencyCodesarray of string
accountCountryCodestring
accountCountryExcludedCodestring
A billing country this method does not accept.
accountTypestring
One of private, organisation.
accountCurrencyCodestring
requiresCardVerificationboolean
Whether a saved card or an earlier successful card payment is needed.
availableBalanceobject
amountnumber
currencyCodestring
minimumAmountobject
amountnumber
currencyCodestring
comparisonstring
How the payment amount must compare with amount. 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.
maximumAmountobject
amountnumber
currencyCodestring
comparisonstring
How the payment amount must compare with amount. 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.
alipayobject
methodstring
The payment method, the same as its key in paymentMethods. Card checkout and wallets are all card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto.
labelstring
The method’s name, for display.
availableboolean
visibleboolean
Present for restricted methods. When false, don’t show the method to the customer.
reasonstring or null
Why the method cannot be used, when available is false.
checkoutModestring or null
The kind of hosted checkout the payment session uses. Null for methods without a hosted checkout. One of payment, sepa_bank_transfer_payment, alipay_payment.
requirementsobject
What the payment method needs. Examples: a minimum amount for card, a Swedish account for Swish and bankgiro, EUR for a SEPA bank transfer, an eligible account for cryptocurrency, enough account credit.
invoiceCurrencyCodestring
invoiceCurrencyCodesarray of string
accountCountryCodestring
accountCountryExcludedCodestring
A billing country this method does not accept.
accountTypestring
One of private, organisation.
accountCurrencyCodestring
requiresCardVerificationboolean
Whether a saved card or an earlier successful card payment is needed.
availableBalanceobject
amountnumber
currencyCodestring
minimumAmountobject
amountnumber
currencyCodestring
comparisonstring
How the payment amount must compare with amount. 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.
maximumAmountobject
amountnumber
currencyCodestring
comparisonstring
How the payment amount must compare with amount. 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.
cryptoobject
methodstring
The payment method, the same as its key in paymentMethods. Card checkout and wallets are all card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto.
labelstring
The method’s name, for display.
availableboolean
visibleboolean
Present for restricted methods. When false, don’t show the method to the customer.
reasonstring or null
Why the method cannot be used, when available is false.
checkoutModestring or null
The kind of hosted checkout the payment session uses. Null for methods without a hosted checkout. One of payment, sepa_bank_transfer_payment, alipay_payment.
requirementsobject
What the payment method needs. Examples: a minimum amount for card, a Swedish account for Swish and bankgiro, EUR for a SEPA bank transfer, an eligible account for cryptocurrency, enough account credit.
invoiceCurrencyCodestring
invoiceCurrencyCodesarray of string
accountCountryCodestring
accountCountryExcludedCodestring
A billing country this method does not accept.
accountTypestring
One of private, organisation.
accountCurrencyCodestring
requiresCardVerificationboolean
Whether a saved card or an earlier successful card payment is needed.
availableBalanceobject
amountnumber
currencyCodestring
minimumAmountobject
amountnumber
currencyCodestring
comparisonstring
How the payment amount must compare with amount. 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.
maximumAmountobject
amountnumber
currencyCodestring
comparisonstring
How the payment amount must compare with amount. 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 string
actionsobject
canPayWithAvailableMethodobject
allowedboolean
True when the action can be called now.
reasonstring or null
Why the action is blocked, ready to show. Null when allowed is true.
warningsarray of object
codestring
One of unused_prepaid_bandwidth_credited_after_period.
severitystring
One of info.
reasonstring
scheduledboolean
scheduledChangeobject
statusstring
One of preview, scheduled, awaiting_payment, paid, applying, applied, needs_attention, cancelling, cancelled.
effectiveAtstring or null
invoiceIssueAtstring or null
targetobject
productSlugstring
resourcesobject
The resources after the change, as checked by the server. For a VPS plan change storageGb can be larger than the new plan’s disk. The primary disk cannot be made smaller.
billingobject
amountnumber or null
currencyCodestring
billingCyclestring
One of monthly, quarterly, semiannually, annually, biennially, triennially, free.
actionsobject
canCancelobject
allowedboolean
True when the action can be called now.
reasonstring or null
Why the action is blocked, ready to show. Null when allowed is true.
actionsobject
canCommitobject
allowedboolean
True when the action can be called now.
reasonstring or null
Why the action is blocked, ready to show. Null when allowed is true.

Errors

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

400The 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.
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.
409The 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.
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.
502Billing data the change depends on could not be read or updated, such as currency, tax, prices, usage or the renewal. Try again shortly.