v12

latestOpenAPI 3.0.3raw.githubusercontent.com2026-06-1811583196.1 KB
Virtual Machines

Resize VM

Resize a virtual machine's CPU and RAM by selecting a new pricing plan. The VM must be stopped before resizing.

Billing

For subscription VMs, the price difference is calculated pro-rata for the remaining billing period:

  • Upgrade — the difference is deducted from credits, then account balance. If your balance is insufficient, the request fails with 402.
  • Downgrade — the pro-rata credit is added to your account balance.

The new subscription price takes effect immediately.

post/api/v1/vms/{id}/resize

Path parameters

idstring uuid required

VM ID (UUID)

Headers

X-Project-IDstring uuid required

Project ID. Required for all mutating operations (create, delete, power actions, resize).

Request body

pricing_idinteger required

Target pricing plan ID. Determines CPU, RAM, and included storage. Use GET /api/v1/public/pricing/vm to list available plans.

Response

VM resized

successboolean
messagestring
idstring

Resource ID.

Example response

{
  "success": true
}