Get computer
Retrieve a computer by ID.
desktops from List workspaces or Get workspace.
Path parameters
Response
canView, canWrite, canManageAccess, and canUseAgent, each a boolean.password, secret, token, api_key, or authorized_keys removed.creating, running, restarting, updating, suspending, suspended, resuming, frozen, stopped, error, deleted. See Status values.http://{host}:{port}. This is an internal fleet address, not a dashboard link and not the endpoint you connect to. Use connection_url to connect. The value is rewritten whenever the computer restarts, is started again, or has its RAM resized. It still holds the last host’s address after the computer is stopped, so it is only meaningful while the computer is running.POST /computers returns as instance_id. It changes when the computer is started from its archive or wakes from storage, so keep id (the UUID) as your handle and read this fresh from this endpoint. null while the computer has no host (frozen, or asleep in storage). This endpoint returns the field under its legacy name only.www.orgo.ai. Empty while the computer has no instance id, such as when it is frozen or asleep in storage.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}. Empty while the computer has no instance id, such as when it is frozen or asleep in storage.null when you have Can chat access to the workspace, when a restricted key lacks Control write, for an MCP sign-in or a computer’s identity token, while the computer is locked (see lock), while its password is being changed, or when the stored credential cannot be decrypted. A restricted or expiring key also gets null for a computer that holds its own Orgo key.true when the computer’s workspace keeps screens private, so the Orgo dashboard keeps the screen covered until someone chooses to show it.host_cpu (family, name, and signature, or null), cpu_model, hypervisor, qemu, boot, fallback, and launched_at. null when the host has not reported a launch record for the computer’s current VM.null for a computer on Orgo’s servers.suspended computer is. null for any other status. where is host (resumes on interaction) or storage (moved off its host; Start, Resume, or any action wakes it in about a minute). since is when it went to sleep. Both carry waking ({ since, expected_seconds } while a wake from storage runs, else null) and wake_error (why the last wake failed, else null). A computer in storage also carries reason (hours, idle, or null).suspending, suspended, or resuming: state (capturing, uploading, stored, resuming, resumed, failed, or abandoned), where (host or storage), saving (true while its copy is still being saved; Resume and Delete still work meanwhile), and region (the storage region, or null). null for any other status or when nothing is recorded. Get suspension has the full record.reason (over_capacity), locked_at, and cap (how many computers the plan allows). The computer keeps running, but every way in is refused until the account has room. null otherwise.null when it never ends. Set, move, or clear it with Update computer."delete": the computer is deleted at ends_at, which every end set now does. "stop": an end set before every end deleted the computer, which stops it at ends_at and deletes it 7 days later unless it is started. null when it has no end.on_end "stop" computer: when Orgo stopped it because its time ran out, or marked it ended if it was already off. A computer that keeps this value keeps its ends_at beside it. null when it has not ended, and always for an on_end "delete" computer. Starting or resuming the computer clears it.on_end "delete" it is ends_at. For an on_end "stop" computer that has ended it is 7 days after ended_at: start it before then and it is kept, with no end or with the end the Start sends. Taking the end off with Update computer keeps either one. null otherwise.ends_at, unless someone who may not prepay moved the end later; the time past prepaid_until is then billed by the hour. null for an hourly computer with no prepay, for a stopped one, and for any computer on a plan.null whenever prepaid_until is.us, eu or apac. From the server it runs on, or from the region it was created with when that is not known. null before it is placed. See Choose where a computer runs.chi, lon or syd. null before it is placed, and for a computer in the US whose city Orgo does not record.last_at (ISO 8601) and kills_24h (how many programs it stopped in the last 24 hours). null until that has happened.billing_mode: "hourly" in instance_details. What happens when a computer’s time runs out, and what an hourly computer prepays, is described in Computers with an end.
A Mac computer that runs as a virtual machine also carries mac_features (which backups, snapshots, and restores its Backups tab offers) and mac_job (the restore it is part of now, or null). No other computer has these fields.
Status values
Example
Response
Errors
Rename a computer or change its end
PATCH /computers/{id} renames a computer, sets its mascot, and sets, moves, or clears when it ends. It is described in Update computer.Authorizations
Response
Computer details
A computer. No single response carries every field: POST /computers returns workspace_id, project_id, instance_id, fly_instance_id, and the connect fields, plus hardware and launch when the host reports them, and ends_at (with on_end when you sent ends_in_hours or on_end, and prepaid_until and prepaid_cents for an hourly create with an end); GET /computers/{id} returns project_id, project_name, permissions, fly_instance_id, the connect fields, private_screens, hardware, device_tag, asleep, suspension, lock, and the end and prepay fields (ends_at, on_end, ended_at, deletes_at, prepaid_until, prepaid_cents); a computer embedded in a workspace carries the stored row. Each operation's example shows what that operation returns.
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 restart, on start, and on a RAM resize, so do not persist it. null when you have Can chat access to the workspace, when a restricted key lacks Control write, for an MCP sign-in or a computer's identity token, while the computer is locked, while its password is being changed, or when the stored credential cannot be decrypted.
"a06db12a8683df96"
The instance id under its legacy name. The same value POST /computers returns as instance_id. GET /computers/{id} returns only this name. It changes when the computer is started from archive or woken from storage, so use id. null while it has no host (frozen, or asleep in storage).
"a3881618"
The computer's placement and connection record: provider, id, name, webUrl, vncHost, vncPort, apiPort, serverAddress, resolution, and fromPool, plus hypervisor and templateTerminals when they apply. GET /computers/{id} and the workspace endpoints remove every field whose name contains password, secret, token, api_key, or authorized_keys, in any letter case and at any depth.
What the computer runs on, from its current VM's launch record. GET /computers/{id} always returns it, null when the host has not reported a launch record for the computer's current VM. POST /computers returns it, with launch, only when the host reports how it launched the computer.
Returned by GET /computers/{id}, and by POST /computers when you sent ends_in_hours or on_end. What happens at the end, read only: "delete" (deleted at ends_at, as every end set now is), "stop" (an end set before every end deleted the computer: stopped at ends_at, deleted 7 days later unless it is started), or null with no end.
delete, stop, null A computer that runs by the hour and is running out a prepaid end: when its prepaid run ends. This is ends_at, unless someone who may not prepay moved the end later. null for an hourly computer with no prepay, a stopped one, and any computer on a plan. GET /computers/{id} always returns it; POST /computers only for an hourly create with ends_in_hours.
Returned by POST /computers only, when you sent ends_in_hours and the computer was made without an end: This computer can’t have an end, so it keeps running until you stop it. or The computer was made, but its end could not be saved, so it keeps running until you stop it. Do not retry the create.