Skip to main content
PATCH
Resize computer
Resizes a running computer. Every field is optional. Send only what you want to change.
vcpus and bandwidth_limit_mbps apply to the live computer. Disk growth applies live on Linux; a Windows computer restarts in place to grow its disk. A mem_gb change applies live on a Linux computer that supports live memory resize, and restarts any other computer in place. connection_rotated is true when the ports or VNC password changed. When it is, re-fetch GET /computers/{id} and reconnect.
The computer must be running. The response reports the values the computer actually accepted, not the ones you asked for: a dimension that failed to apply comes back with its previous value. A computer that runs by the hour follows its own rules: see A computer that runs by the hour.

Path parameters

string
required
Computer UUID or instance_id. Both resolve to the same computer.

Body parameters

string
A named size that sets vcpus and mem_gb together, as on create: small, medium, large, xl, or 2xl. A vcpus or mem_gb sent beside it wins. Any other value returns 400 with code: "INVALID_SIZE". Omitted leaves both alone.
number
New vCPU count: 0.5, 1, 2, 4, 6, 8, or 16, as a JSON number. Any other value returns 400. Growth past 6 (XL) returns 403 with code: "CONTACT_US_FOR_SIZE" unless Orgo has set your account up for computers past XL. On an account that is, a value above 8, the per-computer cap, returns 403 with code: "PER_COMPUTER_CPU_CAP". Growth past what the account’s vCPU pool leaves this computer returns 403 with code: "VCPU_ADDON" and max_cpu. A computer keeps the vCPU threads it booted with until it restarts, and a change past them fails in results until you restart it: GET /computers/{id}/resize reports them as vcpu_threads. Sending the current value changes nothing. Omitted leaves CPU alone.
integer
New RAM in GB: 4, 8, 16, or 32, as a JSON number. Growth to 64 returns 403 with code: "CONTACT_US_FOR_SIZE" unless Orgo has set your account up for computers past XL. Any other value returns 400. On an account that is set up past XL, a resize still tops out at the host’s boot-memory ceiling, 32 GB by default: 64 returns 400 unless the fleet is configured above that ceiling, so a 64 GB computer is otherwise reachable only at create time. A value above what your other computers leave of the account’s total RAM returns 403. Shrinking a Linux computer below what it is using returns 409 with code: "RAM_IN_USE". Omitted leaves RAM alone.
integer
New disk size in GB. Disk can only grow; a value below the current size returns 400. A value below 1 or above this computer’s ceiling also returns 400, with max_disk_gb in the body. Omitted leaves the disk alone. Call GET /computers/{id}/resize to read the ceiling first.
integer
New bandwidth cap in Mbps. Must be a non-negative number and no higher than the workspace owner’s plan limit; both violations return 400. 0 is accepted but leaves the cap unchanged. Omitted leaves the cap alone.
integer
Idle minutes before the computer suspends itself. 0 means always-on. Omitted leaves the current setting alone. This is applied separately from the four hardware dimensions and is not reflected in results. Orgo does not check the value before resizing: a value the host rejects, such as a negative number or more than 43200 (30 days), returns 500 after any hardware change has already applied.

Response

Returns the effective configuration after the resize attempt.
number
Effective vCPU count.
integer
Effective RAM in GB.
integer
Effective disk size in GB.
integer
Effective bandwidth limit in Mbps.
integer
The auto_stop_minutes you sent, echoed back. Absent when you did not send it.
boolean
true when the computer’s ports or VNC password changed. Re-fetch the computer’s connection details before reconnecting.
boolean | null
true when the resize restarted the computer, false when it applied live. null when the host does not report it.
array
Names of connection values the host reports as changed: any of api_port, novnc_port, vnc_password, ssh_host_port, or ip. Empty when nothing changed or the host does not report changes.
object
Windows only, when the disk grew: whether C: was extended to fill it. { "status": "resized" | "noop" | "blocked" | "pending" | "error", "detail": string }. pending means Orgo is still extending it in the background. Absent otherwise.
boolean
GPU computers only, when vcpus or mem_gb changed: true, since a GPU computer restarts for that change. Absent otherwise.
object
GPU computers only, alongside restart_required: what the new size costs: monthly_usd, yearly_usd, hourly_usd, and lines, one per part. Shown, not charged.
array
One entry per attempted dimension: { "dimension": "vcpus" | "mem_mb" | "disk_gb" | "bandwidth_mbps", "requested": number, "applied": number, "ok": boolean, "error"?: string }. This is an array, not an object keyed by dimension. Iterate it and switch on dimension. A dimension sent at its current value has no entry. Absent when the request included no hardware dimension.
boolean
true when at least one dimension failed, false otherwise. It is true on both 207 and 422, so use the HTTP status to tell a mixed result from a total failure. Absent when the request included no hardware dimension.

Status codes

  • 200: every requested dimension applied
  • 207: some dimensions applied and others failed (check results)
  • 422: every requested dimension failed

Example

Response

Errors

A VCPU_ADDON, RAM_ADDON, or DISK_QUOTA_EXCEEDED refusal that more room on the plan would clear also carries short (vcpu, ram_gb, disk_gb), monthly_usd, and can_add_room. The workspace owner, signed in or with an account-wide key that has Billing write, also gets next: the calls that price the room, add it, and resize again. Anyone else gets a hint instead.

A computer that runs by the hour

A running hourly Linux computer, on a paid plan or an account Orgo has set to pay from credits, changes its vcpus and mem_gb to any size sold by the hour, and its rate changes from that moment. A prepaid run is held again at the new rate. Windows, GPU, trial and Bops hourly computers keep their size (409 COMPUTE_HARDWARE_PINNED).
  • Its disk, bandwidth and auto-stop stay. A different disk_size_gb returns 400 with code: "HOURLY_DISK_FIXED", and bandwidth_limit_mbps or auto_stop_minutes returns 400 with code: "NOT_RESIZABLE".
  • A size not sold by the hour returns 400 with code: "HOURLY_SIZE_UNAVAILABLE" and the sizes it can take.
  • A higher rate spends the owner’s credit, so only the workspace owner may ask for one, signed in or with an account-wide key that has Billing write. Anyone else gets 403 with code: "HOURLY_NEEDS_BILLING". A lower rate needs only write access.
  • A higher rate needs credit for an hour at it plus an hour of the owner’s other hourly computers. With a prepay, it needs what the rest of the run costs at the new rate past what is held, plus that hour. Short, it returns 402 with code: "INSUFFICIENT_COMPUTE_CREDIT", running_usd_per_hour, stopped_usd_per_hour, credit_usd and credit_floor_usd.
The answer is the normal response plus running_usd_per_hour and stopped_usd_per_hour (the new rates), and prepaid_until and prepaid_cents.

Read the ceilings before resizing

GET /computers/{id}/resize returns this computer’s headroom, so you can size a request before making it. It takes the same path parameter and no body.
integer
The computer’s current disk size in GB.
integer
Per-computer disk included in the workspace owner’s plan.
integer
Storage add-on blocks the owner has purchased.
integer
Those blocks expressed in GB.
integer
The largest disk_size_gb this computer can be resized to. It is the plan’s base plus whatever add-on storage the owner’s other computers have not already claimed, up to hard_max_disk_gb.
integer
The most disk one computer of this account can have, whatever storage is bought: 300, unless Orgo raised it for the account, up to 1000.
integer
The largest mem_gb this computer can be resized to, already bounded by the live-resize limit and by what the owner’s other computers leave of the account’s total RAM.
number
The largest vcpus this computer can be resized to: what the account’s vCPU pool leaves it beside the owner’s other computers, up to the per-computer limit, and never below what it has now.
integer
The largest bandwidth_limit_mbps the workspace owner’s plan allows.
integer
Pooled RAM the owner has purchased, in GB.
number
Pooled vCPU the owner has purchased.
integer
The most RAM this computer could reach by resize if you bought more. No add-on lifts it.
number
The per-computer vCPU ceiling, 8, or lower when your plan is a custom one that sets its own. No add-on lifts it.
number
The most vCPU you can resize this computer to on your own: the lower of 6 (XL) and hard_max_cpu, or hard_max_cpu itself when past_xl_allowed is true. Past it, the PATCH returns CONTACT_US_FOR_SIZE.
integer
The most RAM you can resize this computer to on your own: the lower of 32 (XL) and hard_max_ram_gb, or hard_max_ram_gb itself when past_xl_allowed is true.
boolean
true when Orgo has set the workspace owner’s account up for computers past XL (more than 6 vCPU or 32 GB RAM).
integer
The vCPU threads the computer booted with: the most vcpus a resize reaches before the computer restarts. A change past it fails in results. Absent when the host cannot say, for example when the computer is not running.
boolean
true when a mem_gb change applies without restarting the computer. Absent when the host cannot say, for example when the computer is not running.
A computer that cannot be resized, such as a physical device, an operating system without resize support, or a computer whose hardware its billing fixes, returns 200 with a different shape: resizable: false, reason, code (COMPUTE_HARDWARE_PINNED with pinned_by for the billing case), and current_disk_gb, max_disk_gb, max_ram_gb, and max_cpu all set to its current size. A computer that runs by the hour and can change size answers without base_disk_gb, blocks, add_on_gb, max_bandwidth_mbps, addon_ram_gb, and addon_vcpu, with max_disk_gb at its current disk, and adds hourly: running_usd_per_hour, stopped_usd_per_hour, may_spend (whether you may pick a higher rate), credit_usd (only when may_spend), prepaid_until, prepaid_cents, and sizes, each with cpu, ram_gb, its two rates and, when may_spend, credit_floor_usd.

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<number>

New vCPU count. Omitted, the CPU is left alone. Growth past 6 (XL) returns 403 (CONTACT_US_FOR_SIZE) unless Orgo has set your account up for computers past XL; on such an account, above 8 returns 403 (PER_COMPUTER_CPU_CAP). A live change past the vCPU threads the computer booted with (vcpu_threads) needs a restart first. Capped by the workspace owner's plan; call GET /computers/{id}/resize for the ceiling.

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

New RAM in GB. Omitted, the RAM is left alone. Growth to 64 returns 403 (CONTACT_US_FOR_SIZE) unless Orgo has set your account up for computers past XL. On such an account a resize still tops out at the host's boot-memory ceiling, 32 GB by default: 64 returns 400 unless the fleet is configured above that ceiling, so a 64 GB computer is otherwise reachable only at create time. Above your per-computer ceiling, or more than your other computers leave in the account's RAM pool, returns 403. Call GET /computers/{id}/resize for the ceiling.

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

New disk size in GB. Omitted, the disk is left alone. Grow only: a smaller value returns 400. Below 1 or above this computer's ceiling also returns 400, with max_disk_gb.

bandwidth_limit_mbps
integer

New bandwidth cap in Mbps. Omitted, the cap is left alone. Must be non-negative and no higher than the owner's plan limit; either violation returns 400.

auto_stop_minutes
integer

Idle minutes before the computer suspends itself. 0 means always-on. Omitted, the setting is left alone. Applied separately from the hardware dimensions and not reflected in results. Orgo does not check the value first: a value the host rejects, such as a negative number or more than 43200 (30 days), returns 500 after any hardware change has already applied.

size
enum<string>

A named size that sets vcpus and mem_gb together, as on create. A vcpus or mem_gb sent beside it wins. Any other value returns 400 (INVALID_SIZE).

Available options:
small,
medium,
large,
xl,
2xl

Response

Every requested dimension applied

The effective configuration after the resize attempt. A dimension that failed to apply comes back with its previous value.

vcpus
number

Effective vCPU 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

The auto_stop_minutes you sent, echoed back. Absent when you did not send it.

connection_rotated
boolean

true when the computer's ports or VNC password changed. Re-fetch GET /computers/{id} before reconnecting.

restarted
boolean | null

true when the resize restarted the computer, false when it applied live, null when the host does not report it.

identity_changed
enum<string>[]

Connection values the host reports as changed. Empty when nothing changed or the host does not report changes.

Available options:
api_port,
novnc_port,
vnc_password,
ssh_host_port,
ip
results
object[]

One entry per attempted hardware dimension. Absent when the request included no hardware dimension.

partial
boolean

true when at least one dimension failed. true on both 207 and 422. Absent when the request included no hardware dimension.

c_drive
object

Windows only, after a disk grow: whether drive C: was extended to use it.

restart_required
boolean

GPU computers only, when vcpus or mem_gb changed.

price
object

GPU computers only, alongside restart_required: monthly_usd, yearly_usd, hourly_usd, and lines. Shown, not charged.

running_usd_per_hour
number

Hourly computers only: the rate after the resize.

stopped_usd_per_hour
number

Hourly computers only.

prepaid_until
string<date-time> | null

Hourly computers only.

prepaid_cents
integer | null

Hourly computers only.