Create computer
Provision a new virtual computer in a workspace.
Request
linux is supported.4, 8, 16, 32, or 64. Capped by your plan’s per-computer limit.1, 2, 4, 8, or 16. Capped by your plan’s per-computer limit.WIDTHxHEIGHTxDEPTH format (e.g., 1024x768x24, 1920x1080x24).namespace/name@version — e.g. system/claude-code@1.0.0 (curated) or default/my-template@1.0.0 (your own). The hardware fields above override the template’s defaults; the template’s build must be ready.Common configurations
Response
Returns the created computer object.WIDTHxHEIGHTxDEPTH format.creating, starting, running, stopping, stopped, restarting, deleting, error.hostname and to reference the VM across restarts.www.orgo.ai.https://www.orgo.ai/desktops/{instance_id}). Append /ws/websockify, /ws/terminal, or /ws/audio for the WebSocket endpoints; HTTP Desktop API calls go to https://www.orgo.ai/api/desktops/{instance_id}/proxy/{endpoint}.POST /computers or GET /computers/{id}.Example
Response
Authorizations
API key authentication. Get your key at orgo.ai/workspaces
Body
ID of the workspace to create the computer in
"550e8400-e29b-41d4-a716-446655440000"
Computer name
1"agent-1"
Operating system
linux CPU cores. Capped by plan.
1, 2, 4, 8, 16 RAM in GB. Capped by plan.
4, 8, 16, 32, 64 Disk size in GB. Capped by plan.
Display resolution in WIDTHxHEIGHTxDEPTH format
"1280x720x24"
Launch from a template's golden snapshot instead of a base image. Format namespace/name@version, e.g. system/claude-code@1.0.0 (curated) or default/my-template@1.0.0 (your own). The hardware fields above override the template's defaults. The template's build must be ready.
"system/claude-code@1.0.0"
Response
Computer created
Unique computer identifier
"a3bb189e-8bf9-3888-9912-ace4e6543002"
Computer name
"agent-1"
Name of the parent workspace
"production"
Operating system
linux "linux"
RAM in GB
4, 8, 16, 32, 64 4
CPU cores
1, 2, 4, 8, 16 1
Disk size in GB
8
Current status
creating, starting, running, stopping, stopped, restarting, deleting, error "running"
Dashboard URL for the computer
"https://orgo.ai/workspaces/a3bb189e-8bf9-3888-9912-ace4e6543002"
Stable identifier for the underlying compute instance. Use this for proxy hostnames and for any client that needs to reference the VM across restarts.
"a3881618"
Same-origin host for the computer's connection endpoints (always www.orgo.ai).
"www.orgo.ai"
Same-origin connection base (https://www.orgo.ai/desktops/{instance_id}). Append /ws/websockify, /ws/terminal, or /ws/audio for WebSocket endpoints; HTTP Desktop API calls go to https://www.orgo.ai/api/desktops/{instance_id}/proxy/{endpoint}.
"https://www.orgo.ai/desktops/a3881618"
VNC / WebSocket Bearer token. Rotates on every restart - do not persist across restarts.
"a06db12a8683df96"