Skip to main content
The Orgo API lets you provision virtual computers and control them programmatically. Build AI agent fleets, automation workflows, or browser testing at scale.

​
Base URL

https://www.orgo.ai/api

​
Authentication

All requests require a Bearer token in the Authorization header: 
Authorization: Bearer sk_live_...
Get your API key at orgo.ai/workspaces.

​
Quick start

​
1. Create a workspace

Workspaces organize your computers. 
curl -X POST https://www.orgo.ai/api/workspaces \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-workspace"}'

​
2. Create a computer

curl -X POST https://www.orgo.ai/api/computers \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "agent-1",
    "os": "linux",
    "ram": 4,
    "cpu": 1
  }'

​
3. Control the computer

# Take a screenshot
curl https://www.orgo.ai/api/computers/a3bb189e-8bf9-3888-9912-ace4e6543002/screenshot \
  -H "Authorization: Bearer $ORGO_API_KEY"

# Click at coordinates
curl -X POST https://www.orgo.ai/api/computers/a3bb189e-8bf9-3888-9912-ace4e6543002/click \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x": 100, "y": 200}'

# Type text
curl -X POST https://www.orgo.ai/api/computers/a3bb189e-8bf9-3888-9912-ace4e6543002/type \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello, world!"}'

# Run bash command
curl -X POST https://www.orgo.ai/api/computers/a3bb189e-8bf9-3888-9912-ace4e6543002/bash \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"command": "ls -la"}'

​
Resource hierarchy

User
└── Workspaces
    └── Computers
Workspaces group related computers together. Use them to separate environments (production, staging) or projects.

​
Computer specs

ParameterOptionsDefault
oslinuxlinux
cpu1, 2, 4, 8, 16 cores1
ram4, 8, 16, 32, 64 GB4
disk_size_gbup to plan limit8
resolutionWIDTHxHEIGHTxDEPTH (e.g., 1024x768x24, 1920x1080x24)1280x720x24
Maximum CPU/RAM/disk per computer is capped by your plan. See https://orgo.ai/pricing.
RAMCPUBest for
4 GB1 coreStandard workflows (default)
8 GB2 coresHeavier automation
16 GB4 coresDevelopment
32 GB8 coresLarge-scale processing

​
Available actions

​
Mouse

  • Click (left, right, double)
  • Drag
  • Scroll

​
Keyboard

  • Type text
  • Press keys (Enter, Tab, ctrl+c, etc.)

​
Execution

  • Bash commands
  • Python code

​
Real-time (WebSocket)

  • Terminal — interactive PTY shell
  • Audio — live PCM audio stream from the VM’s virtual speaker
  • Events — subscribe to window, clipboard, file, process, and idle events

​
Lifecycle

  • Start, stop, restart
  • Auto-stop (configurable on paid plans)
  • Clone (copy a computer with full disk state)
  • Resize (live CPU/RAM/disk hot-resize)
  • Move (transfer between workspaces)

​
Other

  • Screenshots
  • Wait/delays
  • RTMP streaming

​
Error responses

All errors return a JSON object with an error field: 
{
  "error": "Invalid API key"
}
StatusDescription
200Success
400Invalid request
401Invalid or missing API key
404Resource not found
500Server error

​
Rate limits

API requests are rate limited. Contact support if you need higher limits.

​
Next steps

Create Workspace

Organize computers

Create Computer

Provision a VM

Authentication

API key setup

Use Any Model

Claude, GPT, Gemini, and more