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 '
{
  "disk_size_gb": 123,
  "bandwidth_limit_mbps": 123
}
'
{
  "vcpus": 123,
  "mem_gb": 123,
  "disk_size_gb": 123,
  "bandwidth_limit_mbps": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.orgo.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
id
string
required
Computer ID.

​
Body parameters

​
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.
​
auto_stop_minutes
integer
Optional: also update the auto-stop setting as part of the same call. 0 disables auto-stop.

​
Response

Returns the effective configuration after the resize attempt. Values reflect what the VM actually accepted, not what you asked for.
​
vcpus
integer
Effective CPU count.
​
mem_gb
integer
Effective RAM in GB.
​
disk_size_gb
integer
Effective disk size in GB.
​
bandwidth_limit_mbps
integer
Effective bandwidth limit in Mbps.
​
auto_stop_minutes
integer
Echoes the requested auto_stop_minutes if one was supplied.
​
results
object
Per-dimension result breakdown ({requested, applied, ok, error}). Only present if a resize operation ran.
​
partial
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

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,
  "results": {
    "vcpus": { "requested": 4, "applied": 4, "ok": true },
    "mem_mb": { "requested": 8192, "applied": 8192, "ok": true },
    "disk_gb": { "requested": 30, "applied": 30, "ok": true }
  },
  "partial": false
}

​
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. 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