Skip to main content
PATCH
Resize computer
Live-resizes a running computer’s CPU, RAM, disk, or bandwidth without rebooting. All fields are optional - only include what you want to change.
The computer must be in running state. CPU and bandwidth changes apply instantly; RAM and disk grow online. Response surfaces the applied values, not the requested ones - if a dimension didn’t land, its previous value is returned.

Path parameters

string
required
Computer ID.

Body parameters

integer
New CPU count: 1, 2, 4, 8, or 16. Capped by your plan’s per-computer limit.
integer
New RAM in GB: 4, 8, 16, or 32. A live resize tops out at 32 GB (larger sizes are only available when the computer is first created). Also capped by your plan’s per-computer limit.
integer
New disk size in GB. Disk can only grow - shrinking is not supported.
integer
New bandwidth cap in Mbps. Capped by your plan limit.

Response

Returns the effective configuration after the resize attempt. Values reflect what the VM actually accepted, not what you asked for.
integer
Effective CPU count.
integer
Effective RAM in GB.
integer
Effective disk size in GB.
integer
Effective bandwidth limit in Mbps.
object
Per-dimension result breakdown ({requested, applied, ok, error}). Only present if a resize operation ran.
boolean
true if some dimensions failed while others succeeded.

Status codes

  • 200 - All requested dimensions applied successfully
  • 207 - Mixed result - some dimensions applied, others failed (check results)
  • 422 - All requested dimensions failed

Example

Response

Errors

  • 400 - Invalid value (e.g. shrinking disk, value not in allowed list), or not a metal VM
  • 401 - Invalid or missing API key
  • 403 - Value exceeds your plan’s per-computer limit, or no access
  • 404 - Computer not found
  • 409 - Computer is not running
  • 422 - All requested dimensions failed to apply

Authorizations

Authorization
string
header
required

API key authentication. Get your key at orgo.ai/workspaces

Path Parameters

id
string
required

Computer ID

Body

application/json
vcpus
enum<integer>

New CPU count. Capped by plan.

Available options:
1,
2,
4,
8,
16
mem_gb
enum<integer>

New RAM in GB. Live resize is capped at 32 GB (the VMM boot-memory ceiling); larger sizes are only available at create time. Also capped by your plan.

Available options:
4,
8,
16,
32
disk_size_gb
integer

New disk size in GB. Grow only — shrinking not supported.

bandwidth_limit_mbps
integer

New bandwidth cap in Mbps. Capped by plan.

Response

Resize complete

vcpus
integer
mem_gb
integer
disk_size_gb
integer
bandwidth_limit_mbps
integer