Skip to main content
PATCH
/
computers
/
{id}
/
resize
Resize computer
curl --request PATCH \
  --url https://www.orgo.ai/api/computers/{id}/resize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "vcpus": 1,
  "mem_gb": 4,
  "disk_size_gb": 123,
  "bandwidth_limit_mbps": 123
}
'
{
  "vcpus": 123,
  "mem_gb": 123,
  "disk_size_gb": 123,
  "bandwidth_limit_mbps": 123
}
Live-resizes a running computer’s CPU, RAM, disk, or bandwidth without rebooting. Powered by virtio-mem hotplug for memory and online disk expansion for storage.
The computer must be in running state. Resize is instant for CPU and memory; disk expansion runs resize2fs in the background.

Path parameters

id
string
required
Computer ID.

Body parameters

All fields are optional — only include the resources you want to change.
vcpus
integer
New CPU count: 1, 2, 4, 8, or 16. Capped by your plan’s per-computer limit.
mem_gb
integer
New RAM in GB: 4, 8, 16, 32, or 64. Capped by your plan’s per-computer limit.
disk_size_gb
integer
New disk size in GB. Disk can only grow — shrinking is not supported.
bandwidth_limit_mbps
integer
New bandwidth cap in Mbps. Capped by your plan limit.

Response

Returns the new resource configuration.
vcpus
integer
Effective CPU count after resize.
mem_gb
integer
Effective RAM in GB.
disk_size_gb
integer
Effective disk size in GB.
bandwidth_limit_mbps
integer
Effective bandwidth limit.

Example

curl -X PATCH https://www.orgo.ai/api/computers/a3bb189e-8bf9-3888-9912-ace4e6543002/resize \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vcpus": 4,
    "mem_gb": 8,
    "disk_size_gb": 30
  }'

Response

{
  "vcpus": 4,
  "mem_gb": 8,
  "disk_size_gb": 30,
  "bandwidth_limit_mbps": 1000
}

Errors

  • 400 — Invalid value (e.g. shrinking disk, value not in allowed list)
  • 403 — Value exceeds your plan’s per-computer limit
  • 409 — Computer is not running

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. Capped by plan.

Available options:
4,
8,
16,
32,
64
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