Skip to main content
GET
/
computers
/
{id}
Get computer
curl --request GET \
  --url https://www.orgo.ai/api/computers/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
  "name": "agent-1",
  "project_name": "production",
  "os": "linux",
  "ram": 4,
  "cpu": 1,
  "disk_size_gb": 8,
  "status": "running",
  "url": "https://orgo.ai/workspaces/a3bb189e-8bf9-3888-9912-ace4e6543002",
  "created_at": "2023-11-07T05:31:56Z",
  "instance_id": "a3881618",
  "fly_instance_id": "a3881618",
  "hostname": "www.orgo.ai",
  "connection_url": "https://www.orgo.ai/desktops/a3881618",
  "vnc_password": "a06db12a8683df96"
}
Returns computer details including current status.

​
Path parameters

​
id
string
required
Computer ID (UUID).

​
Response

​
id
string
Computer identifier (UUID).
​
name
string
Computer name.
​
project_name
string
Name of the parent workspace.
​
os
string
Operating system.
​
ram
integer
RAM in GB.
​
cpu
integer
CPU cores.
​
status
string
One of creating, starting, running, stopping, stopped, restarting, suspended, deleting, error.
​
url
string
Dashboard URL.
​
created_at
string
ISO 8601 timestamp.
​
instance_id
string
Stable identifier for the underlying compute instance. Use this to construct the hostname.
​
fly_instance_id
string
deprecated
Deprecated alias for instance_id. Returned for backwards compatibility.
​
hostname
string
Same-origin host for the computer’s connection endpoints (www.orgo.ai).
​
connection_url
string
Same-origin connection base (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}.
​
vnc_password
string
Current VNC / WebSocket token. Rotates on restart.

​
Example

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

​
Response

{
  "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
  "name": "agent-1",
  "project_name": "production",
  "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"
}

​
Errors

  • 401 - Invalid or missing API key
  • 403 - You don’t have access to this computer
  • 404 - Computer not found

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

Computer ID

Response

Computer details

​
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>
​
instance_id
string

Stable identifier for the underlying compute instance. Use this for proxy hostnames and for any client that needs to reference the VM across restarts.

Example:

"a3881618"

​
fly_instance_id
string
deprecated

Deprecated alias for instance_id. Returned for backwards compatibility - new clients should read instance_id.

Example:

"a3881618"

​
hostname
string

Same-origin host for the computer's connection endpoints (always www.orgo.ai).

Example:

"www.orgo.ai"

​
connection_url
string

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

Example:

"https://www.orgo.ai/desktops/a3881618"

​
vnc_password
string

VNC / WebSocket Bearer token. Rotates on every restart - do not persist across restarts.

Example:

"a06db12a8683df96"