Resize a VM

Changes CPU, RAM, OS disk, CPU class, and public/private networking on an existing VM. After the VM is created or CPU, RAM, or CPU class is increased, you can lower those resources 24 hours later. CPU or RAM downgrade is allowed only while the VM is stopped. OS disk size cannot shrink. You cannot switch between attached WAN modes (ipv4 / ipv6 / dual); disable WAN first.

Authorization

bearerAuth

AuthorizationBearer <token>

API key created in the portal (Settings → API Keys). Send as Authorization: Bearer <key>.

In: header

Path Parameters

project_uuid*string

Project UUID.

vmid*integer

VM identifier (VMID).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Resize CPU, RAM, disk, CPU class, and networking on an existing VM.

cores*integer

vCPU count (hotplug vcpus). CPU downgrade requires the VM to be stopped.

Range2 <= value

ram_gb*integer

RAM in GiB. RAM downgrade requires the VM to be stopped.

Range1 <= value

os_disk_gb*integer

OS disk size in GiB. May only stay the same or grow.

Range10 <= value

cpu_mode?string

CPU class: light or regular (default).

Default"regular"

Value in

"light"
"regular"

wan_mode*string

Public WAN: off, ipv4, ipv6, or dual. You cannot switch between attached modes; disable WAN first.

Value in

"off"
"ipv4"
"ipv6"
"dual"

wan_ip?|

Reserved project IPv4 to attach. Omit to pick the next free address.

Lengthlength <= 45

wan_ipv6?|

Reserved project IPv6 to attach. Omit to pick the next free address.

Lengthlength <= 45

release_public_ip?boolean

When disabling WAN, release the address (true) or keep it reserved on the project (false).

Defaulttrue

lan_interfaces?array<>

Response Body

`application/json`

curl -X POST "https://example.com/cloud/project/string/vm/0/upgrade/" \  -H "Content-Type: application/json" \  -d '{    "cores": 2,    "ram_gb": 1,    "os_disk_gb": 10,    "wan_mode": "off"  }'

{  "message": "string"}