Available instances
There is no instance-type identifier to pass. A computer’s size is theram and cpu you send to POST /computers; the names below are shorthand for common pairs, not API values.
Every computer has full API access and boots at 1280x720. Linux is the default operating system. Set
os on create to choose another.
Instance details
Standard
Standard
1 CPU / 4GB RAMThe default instance. Great for lightweight browser automation, simple web scraping, and single-task agents.
Medium
Medium
2 CPU / 8GB RAMHandles heavier browser workloads, multi-tab sessions, and agents that run multiple tools concurrently.
Large
Large
4 CPU / 16GB RAMBuilt for development environments, data processing, and agents running resource-intensive applications.
XL
XL
4 CPU / 32GB RAMHeavy memory for large-scale processing, memory-heavy applications, and enterprise workloads. Pass
ram=64, cpu=4 for the largest computer you can create.Choosing an instance
Web scraping & simple tasks
Standard: 1 CPU / 4GB
Multi-tab browsing & automation
Medium: 2 CPU / 8GB
Dev environments & data processing
Large: 4 CPU / 16GB
Enterprise & memory-intensive work
XL: 4 CPU / 32GB
Usage
Passram and cpu when creating a computer to select your instance type:
Accepted values
POST /computers validates ram, cpu, and os before it provisions anything. A value outside the sets below returns 400 with the accepted set in the message, for example {"error": "cpu must be 0.5, 1, 2, 4, 8, or 16 cores"}. Omit any of the three and you get the default.
Clearing that check is not the whole story. One computer is capped at 4 vCPU, 64 GB RAM, and 300 GB of disk. No plan on sale raises that cap, and add-ons only take you up to it. Your own per-computer ceiling starts below the cap and depends on your plan. See orgo.ai/pricing.
RAM
Integer, optional, in GB. Defaults to4.
Anything else returns
400: {"error": "ram must be 4, 8, 16, 32, or 64 GB"}.
Your plan also caps RAM per computer and RAM across your account, below the 64 GB cap. A request inside the table above can still be refused with
403 on quota grounds. See orgo.ai/pricing for the current limits.CPU
Number, optional, in cores. Defaults to1.
Anything else returns
400: {"error": "cpu must be 0.5, 1, 2, 4, 8, or 16 cores"}.
8 and 16 are in the accepted set, so they clear the value check. They then fail the quota check with 403 and code PER_COMPUTER_CPU_CAP, on every plan on sale. Treat 4 as the real maximum.
OS
String, optional. Defaults tolinux.
Anything else returns
400: {"error": "os must be linux, windows, macos, or android"}. A non-Linux computer is placed on a host that can boot that guest, so capacity for it is narrower than for Linux.
Resolution
Resolution is passed as a string inWIDTHxHEIGHTxDEPTH format. Default is 1280x720x24.
Persistence
A computer’s disk and files persist across stop/start. Stopping a computer archives its disk. Starting it again restores your files and installed software on a fresh host, so the computer comes back with a new IP. In-memory state and running processes are not preserved. Computers run continuously until you explicitly stop them.Included with every instance
All instance types share these capabilities:- Full REST API and SDK access
- Screenshot, mouse, keyboard, and bash execution
- File upload and download
- VNC access