Orgo - Cloud computers for AI agents

A computer boots with one screen and can run up to four. Each screen is its own X server, with its own root window, its own cursor, and its own window manager. An agent working on one screen cannot disturb another. Screens are held in the computer’s memory, not in the database. A computer that restarts comes back with only the screen it boots with.

Path parameters

string

required

Computer ID (UUID). The computer must be up. One that is still being created, or that has been frozen, returns 400.

Response

array

Every screen on the computer, the boot screen first and the rest in display order. Never empty while the computer is up.

Show Screen

string

Screen identifier. The boot screen is always default. A screen you create is named after its display, so :100 is screen-100. Pass this value as ?screen=<id> on an action to target the screen.

string

X display. The boot screen is :99; created screens count up from :100. A display number freed by a destroyed screen is reused by the next screen you create.

integer

Width in pixels.

integer

Height in pixels.

integer

VNC port. Derived from the display rather than looked up: 5900 plus the display number, so :99 is 5999 and :100 is 6000.

integer

WebSocket port bridging that VNC stream: 5981 plus the display number, so :99 is 6080 and :100 is 6081.

boolean

true for the screen the computer booted with. It cannot be destroyed.

Errors

Failures raised before the request reaches the computer carry error alone. Failures relayed back from the computer add request_id and upstream_status.

Status	When	Body
`400`	The computer has nothing running behind it: still being created, or frozen.	`{ "error": "Computer not available" }`
`401`	The Bearer token starts with `sk_` but is not a known Orgo key.	`{ "error": "Invalid API key" }`
`401`	No `Authorization` header, or a Bearer token that is not an `sk_` key.	`{ "error": "Authentication required" }`
`403`	You do not own the computer’s workspace and are not a member of it.	`{ "error": "Access denied" }`
`403`	The API key is scoped to a different workspace.	`{ "error": "…", "code": "workspace_scope_mismatch", "key_workspace_id": "…", "target_workspace_id": "…" }`
`404`	No computer with that ID.	`{ "error": "Desktop not found" }`
`500`	Unexpected failure.	`{ "error": "…", "request_id": "…" }`
`503`	The computer could not be reached.	`{ "error": "Could not reach the desktop. Try again in a moment.", "request_id": "…", "code": "ECONNREFUSED" }`

curl https://www.orgo.ai/api/computers/$COMPUTER_ID/screens \
  -H "Authorization: Bearer $ORGO_API_KEY"

{
  "screens": [
    { "id": "default",    "display": ":99",  "width": 1920, "height": 1080, "vnc_port": 5999, "ws_port": 6080, "default": true },
    { "id": "screen-100", "display": ":100", "width": 1920, "height": 1080, "vnc_port": 6000, "ws_port": 6081, "default": false }
  ]
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Computer ID

Response

The computer's screens

screens

object[]

Show child attributes

Overview

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

List screens

Path parameters

Response

Errors

Authorizations

Path Parameters

Response

​Path parameters

​Response

​Errors

Authorizations

Path Parameters

Response

Path parameters

Response

Errors