Skip to main content
POST
/
computers
Create computer
curl --request POST \
  --url https://www.orgo.ai/api/computers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "agent-1",
  "os": "linux",
  "ram": 4,
  "cpu": 1
}
'
{
  "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
  "name": "agent-1",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "os": "linux",
  "ram": 4,
  "cpu": 1,
  "status": "running",
  "url": "https://orgo.ai/workspaces/a3bb189e-8bf9-3888-9912-ace4e6543002",
  "created_at": "2026-04-07T10:35:00Z"
}
Creates a new virtual computer in a workspace. The computer starts automatically after creation.
Computers boot in under 500ms and come pre-configured with a desktop environment, browser, and common tools.

​
Request

​
workspace_id
string
required
ID of the workspace to create the computer in.
​
name
string
required
Computer name. Must be unique within the workspace.
​
os
string
default:"linux"
Operating system. Currently only linux is supported.
​
ram
integer
default:"4"
RAM in GB: 4, 8, 16, 32, or 64. Capped by your plan’s per-computer limit.
​
cpu
integer
default:"1"
CPU cores: 1, 2, 4, 8, or 16. Capped by your plan’s per-computer limit.
​
disk_size_gb
integer
default:"8"
Disk size in GB. Defaults to 8 GB. Capped by your plan’s per-computer limit.
​
image
string
Custom Docker image reference (e.g., registry.fly.io/orgoforge:tag). Use with templates built via the SDK. See the Templates guide for details.
​
resolution
string
default:"1280x720x24"
Display resolution in WIDTHxHEIGHTxDEPTH format (e.g., 1024x768x24, 1920x1080x24).
​
auto_stop_minutes
integer
Auto-stop after this many minutes of inactivity. Set to 0 to disable. Free-tier computers always auto-stop after 15 minutes (not configurable). Paid plans can set any value or disable auto-stop entirely.

​
Common configurations

RAMCPUBest for
4 GB1 coreStandard workflows (default)
8 GB2 coresHeavier automation
16 GB4 coresDevelopment, memory-intensive tasks
32 GB8 coresLarge-scale processing
64 GB16 coresEnterprise workloads
Maximum CPU/RAM per computer is capped by your plan. See https://orgo.ai/pricing.

​
Response

Returns the created computer object.
​
id
string
Unique computer identifier.
​
name
string
Computer name.
​
workspace_id
string
Parent workspace ID.
​
os
string
Operating system.
​
ram
integer
RAM in GB.
​
cpu
integer
CPU cores.
​
resolution
string
Display resolution in WIDTHxHEIGHTxDEPTH format.
​
status
string
One of creating, starting, running, stopping, stopped, restarting, suspended, deleting, error.
​
auto_stop_minutes
integer
Minutes of inactivity before auto-stop. null if auto-stop is disabled.
​
url
string
URL to view the computer in the dashboard.
​
created_at
string
ISO 8601 timestamp.

​
Example

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
  }'

​
Response

{
  "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
  "name": "agent-1",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "project_id": "550e8400-e29b-41d4-a716-446655440000",
  "os": "linux",
  "ram": 4,
  "cpu": 1,
  "resolution": "1280x720x24",
  "status": "running",
  "url": "https://orgo.ai/workspaces/a3bb189e-8bf9-3888-9912-ace4e6543002",
  "created_at": "2026-04-07T10:35:00Z"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
workspace_id
string
required

ID of the workspace to create the computer in

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
name
string
required

Computer name

Minimum string length: 1
Example:

"agent-1"

​
os
enum<string>
default:linux

Operating system

Available options:
linux
​
cpu
enum<integer>
default:1

CPU cores. Capped by plan.

Available options:
1,
2,
4,
8,
16
​
ram
enum<integer>
default:4

RAM in GB. Capped by plan.

Available options:
4,
8,
16,
32,
64
​
disk_size_gb
integer
default:8

Disk size in GB. Capped by plan.

​
resolution
string
default:1280x720x24

Display resolution in WIDTHxHEIGHTxDEPTH format

Example:

"1280x720x24"

​
image
string

Custom Docker image reference. Use with templates built via the SDK.

Example:

"registry.fly.io/orgoforge:abc123"

​
auto_stop_minutes
integer

Auto-stop after this many minutes of inactivity. Set to 0 to disable. Free tier locked to 15 minutes.

Required range: x >= 0
Example:

30

Response

Computer created

​
id
string

Unique computer identifier

Example:

"a3bb189e-8bf9-3888-9912-ace4e6543002"

​
name
string

Computer name

Example:

"agent-1"

​
project_name
string

Name of the parent workspace

Example:

"production"

​
os
enum<string>

Operating system

Available options:
linux
Example:

"linux"

​
ram
enum<integer>

RAM in GB

Available options:
4,
8,
16,
32,
64
Example:

4

​
cpu
enum<integer>

CPU cores

Available options:
1,
2,
4,
8,
16
Example:

1

​
disk_size_gb
integer

Disk size in GB

Example:

8

​
status
enum<string>

Current status

Available options:
creating,
starting,
running,
stopping,
stopped,
restarting,
suspended,
deleting,
error
Example:

"running"

​
url
string

Dashboard URL for the computer

Example:

"https://orgo.ai/workspaces/a3bb189e-8bf9-3888-9912-ace4e6543002"

​
created_at
string<date-time>