Skip to main content
POST
Adds the memory, vCPU and disk of count computers of size (and, for "os": "windows", a Windows license each) to the account’s pool, at the same prices as the Plan tab. The charge for the rest of the current period is made now, paid from your credits first and then the card on file, and the full amount joins every renewal after it.
It adds room, not computers. An account on a paid plan can have 50 computers, plan and hourly together, and past 50 more run by the hour from your credit, up to 999 an account, as described in Computers per account. You do not need this to go past your plan: a create past its vCPU or RAM room runs by the hour from your credit, as described in Create a computer.

Memory, vCPU or storage on their own

To add an amount that is not a computer’s worth, add parts to the account’s pool on their own. Every plan computer draws from it. Send amounts to add, in their billed steps: vCPU in 0.5s, RAM in whole GB, storage in 20 GB.
That one is $65 a month: 4 vCPU at $5, 16 GB at $2.50 and 100 GB at $1 per 20 GB (rates in Get capacity). term and dry_run work the same as for computers; nothing else goes beside addon.

Any shape

Not only the sizes: send all three parts, or a size with some replaced.
RAM is 4, 8, 16, 32 or 64 GB, vCPU 0.5, 1, 2, 4, 6 or 8, and disk 20 to 300 GB in steps of 20.

Price it first

Send dry_run: true to see the charge without making it:

Retries never buy twice

Send an Idempotency-Key header, a new UUID per purchase. If the connection drops before the answer arrives, retry with the same key and body: you get the first answer back, marked Idempotent-Replayed: true, and nothing is bought again.

The self-serve cap

Every account can add up to 800 GB of RAM, 200 vCPU and 4,000 GB of disk on its own, 100 Mediums’ worth. Past that, a purchase returns 403 with code capacity_cap, naming the limit it would pass:
self_serve_cap.computers is the old limit on computer slots, which are no longer sold. A purchase adds no slot, so it never reaches that limit. Ask us and we raise the cap for the account. Raising it adds memory, vCPU and disk you may buy, not computers. Nothing else about the account changes.

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string

A unique value per purchase, such as a UUID (8 to 255 printable characters). Keys last 24 hours.

Required string length: 8 - 255

Body

application/json

The memory, vCPU and disk of computers of a size, any shape (all of ram_gb, vcpu and disk_gb), or a size with some parts replaced. It adds room to the pool, not computers.

count
integer
required

How many computers' worth to add.

Required range: 1 <= x <= 500
size
enum<string>

The size of each computer. Or leave it out and send all of ram_gb, vcpu and disk_gb.

Available options:
small,
medium,
large,
xl,
2xl
ram_gb
enum<integer>

Each computer's RAM, replacing the size's.

Available options:
4,
8,
16,
32,
64
vcpu
enum<number>

Each computer's vCPU, replacing the size's.

Available options:
0.5,
1,
2,
4,
6,
8
disk_gb
integer

Each computer's disk, replacing the size's.

Required range: 20 <= x <= 300Must be a multiple of 20
os
enum<string>
default:linux

windows adds a Windows license per computer, when windows_available is true.

Available options:
linux,
windows
term
enum<string>
default:monthly

Billing term, from terms.

Available options:
monthly,
yearly
dry_run
boolean
default:false

Price the purchase without making it.

Response

Added, with the account's capacity after it. For dry_run: monthly_usd, due_now_usd, next_invoice_usd and next_invoice_at, and nothing is charged.

added
object
capacity
object