Skip to main content
GET
Get computer operation
Use the poll_url returned by an asynchronous start or stop. Authenticate each poll with the same API key. status is queued, running, succeeded, failed, or needs_review. Poll every two seconds while queued or running. A successful operation has a result; failed operations have an error containing error, code, and status. needs_review means the connection or worker was interrupted and the result is uncertain. Contact support with the operation ID. A second start or stop is blocked until that operation is reconciled, to avoid repeating an action that may already have completed. Operations are scoped to their computer and workspace. An unknown operation or one belonging to another computer returns 404.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Computer UUID or instance ID.

operationId
string<uuid>
required

Response

Operation state.

id
string<uuid>
desktop_id
string<uuid>
action
enum<string>
Available options:
start,
stop
status
enum<string>
Available options:
queued,
running,
succeeded,
failed,
needs_review
result
object | null
error
object | null
created_at
string<date-time>
updated_at
string<date-time>
poll_url
string