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": 2
}
'
{
  "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
  "name": "agent-1",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "os": "linux",
  "ram": 4,
  "cpu": 2,
  "gpu": "none",
  "status": "starting",
  "url": "https://orgo.ai/workspaces/a3bb189e-8bf9-3888-9912-ace4e6543002",
  "created_at": "2024-01-15T10: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.
​
cpu
integer
default:"2"
CPU cores: 2, 4, 8, or 16.
​
gpu
string
default:"none"
GPU type: none, a10, l40s, a100-40gb, or a100-80gb.
​
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). Defaults to 1280x720x24.

​
RAM/CPU combinations

Resources follow a 2:1 ratio (RAM:CPU). Common configurations:
RAMCPUBest for
4 GB2 coresStandard workflows (default)
8 GB4 coresHeavy automation, multiple apps
16 GB8 coresDevelopment, memory-intensive tasks
32 GB8 coresLarge-scale processing
64 GB16 coresEnterprise workloads

​
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.
​
gpu
string
GPU type.
​
resolution
string
Display resolution in WIDTHxHEIGHTxDEPTH format.
​
status
string
Current status: starting, running, stopping, stopped, or error.
​
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": 2
  }'

​
Response

{
  "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
  "name": "agent-1",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "os": "linux",
  "ram": 4,
  "cpu": 2,
  "gpu": "none",
  "resolution": "1280x720x24",
  "status": "starting",
  "url": "https://orgo.ai/workspaces/a3bb189e-8bf9-3888-9912-ace4e6543002",
  "created_at": "2024-01-15T10: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 (unique within workspace)

Required string length: 1 - 64
Example:

"agent-1"

​
os
enum<string>
default:linux

Operating system

Available options:
linux
​
ram
enum<integer>
default:4

RAM in GB

Available options:
4,
8,
16,
32,
64
​
cpu
enum<integer>
default:2

CPU cores

Available options:
2,
4,
8,
16
​
gpu
enum<string>
default:none

GPU type (coming soon)

Available options:
none,
a10,
l40s,
a100-40gb,
a100-80gb
​
image
string

Custom Docker image reference (e.g., registry.fly.io/orgoforge:tag). Use with templates built via the SDK.

Example:

"registry.fly.io/orgoforge:abc123-def456"

Response

Computer created

​
id
string

Unique computer identifier

Example:

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

​
name
string

Computer name

Example:

"agent-1"

​
workspace_id
string

Parent workspace ID

Example:

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

​
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:
2,
4,
8,
16
Example:

2

​
gpu
enum<string>

GPU type

Available options:
none,
a10,
l40s,
a100-40gb,
a100-80gb
Example:

"none"

​
status
enum<string>

Current status

Available options:
starting,
running,
stopping,
stopped,
error
Example:

"running"

​
url
string

URL to view the computer

Example:

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

​
created_at
string<date-time>

Creation timestamp