> ## Documentation Index > Fetch the complete documentation index at: https://docs.orgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get computer operation > Poll an asynchronous start or stop. Use the `poll_url` returned by an asynchronous [start](/api-reference/computers/start) or [stop](/api-reference/computers/stop). Authenticate each poll with the same API key. The response contains `id`, `desktop_id` (the computer UUID), `action` (`start` or `stop`), `status`, `result`, `error`, `created_at`, `updated_at`, and `poll_url`. `status` is `queued`, `running`, `succeeded`, `failed`, or `needs_review`. Poll every two seconds while queued or running; the response carries `Retry-After: 2`. A successful operation has a `result` such as `{ "success": true }`; failed operations have an `error` containing `error`, `code`, and `status`. `needs_review` means the host's answer was lost and the result is uncertain. Orgo checks the computer and settles the operation as `succeeded` or `failed` on its own, within about two hours at most. A second start or stop returns `409` until then, to avoid repeating an action that may already have completed. Operations are scoped to their computer and workspace. A missing or invalid API key returns `401` with `{ "error": "Authentication required" }` or `{ "error": "Invalid API key" }`. An unknown operation, an `operationId` that is not a UUID, or one belonging to another computer returns `404` with `{ "error": "Operation not found" }`. An unknown computer returns `404` with `{ "error": "Desktop not found" }`, and a workspace you cannot access returns `403`. A view-only member is also refused with `403` and `{ "error": "This workspace is view-only. Ask the owner for write access (workspace_read_only)." }`: polling an operation counts as a write in the access check. A trial computer whose trial has ended returns `402` with `{ "error": "Choose a plan to continue." }`. If Orgo cannot verify the credential because of a server-side fault, such as a database outage, the poll returns `503` with `{ "error": "Service temporarily unavailable. …" }` and `Retry-After: 5`. Retry after that delay; do not rotate the key. ## OpenAPI ````yaml GET /computers/{id}/operations/{operationId} openapi: 3.1.0 info: title: Orgo API description: >- Launch cloud computers that AI agents can control and interact with. Create workspaces, provision computers, and control them programmatically. version: 2.0.0 contact: name: Orgo Support email: spencer@orgo.ai url: https://orgo.ai servers: - url: https://www.orgo.ai/api description: Production security: - bearerAuth: [] tags: - name: Account description: >- Account capacity: how many computers an account may run, and adding or giving back more. - name: Clients description: >- Run Orgo for your clients from your own app: a workspace and scoped key each, billed to you or to them. - name: Workspaces description: Organize computers into named workspaces - name: Computers description: Provision and manage virtual computers - name: Computer Lifecycle description: Start, stop, and restart computers - name: Computer Actions description: Control mouse, keyboard, and execute commands - name: Screens description: >- More than one desktop on a single computer. Each screen is its own X server with its own cursor and window manager, so an agent working on one cannot disturb another. - name: Files description: Upload and download files - name: Templates description: Author, build, and launch reproducible computers from templates paths: /computers/{id}/operations/{operationId}: get: tags: - Computer Lifecycle summary: Get computer operation description: >- Polls an asynchronous start or stop. Use the `poll_url` from the `202` and the same credential. Poll every two seconds while `queued` or `running`. `needs_review` means the host's answer was lost; Orgo settles it on its own, and a new start or stop returns `409` until then. operationId: getComputerOperation parameters: - name: id in: path required: true schema: type: string description: Computer UUID or instance ID. - name: operationId in: path required: true schema: type: string format: uuid responses: '200': description: Operation state. content: application/json: schema: $ref: '#/components/schemas/ComputerOperation' example: id: 5f0c7a1e-2b3d-4c5e-8f9a-0b1c2d3e4f5a desktop_id: a3bb189e-8bf9-3888-9912-ace4e6543002 action: stop status: succeeded result: success: true error: null created_at: '2026-04-07T10:35:00Z' updated_at: '2026-04-07T10:35:42Z' poll_url: >- /api/computers/a3bb189e-8bf9-3888-9912-ace4e6543002/operations/5f0c7a1e-2b3d-4c5e-8f9a-0b1c2d3e4f5a headers: Retry-After: description: Always `2`. schema: type: string example: '2' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/TrialInactive' '403': $ref: '#/components/responses/AccessDenied' '404': description: >- No computer with this id, or no such operation on it (including an `operationId` that is not a UUID). content: application/json: schema: $ref: '#/components/schemas/Error' examples: no-computer: summary: Unknown computer value: error: Desktop not found no-operation: summary: Unknown operation value: error: Operation not found '503': $ref: '#/components/responses/AuthUnavailable' components: schemas: ComputerOperation: type: object properties: id: type: string format: uuid desktop_id: type: string format: uuid action: type: string enum: - start - stop status: type: string enum: - queued - running - succeeded - failed - needs_review result: type: - object - 'null' description: 'On success, such as `{ "success": true }`.' error: type: - object - 'null' description: 'On failure: `error`, `code`, and `status`.' created_at: type: string format: date-time updated_at: type: string format: date-time poll_url: type: string Error: type: object description: >- The base error body. Every failure carries `error`; individual endpoints add the fields named in the schemas below. required: - error properties: error: type: string description: Human-readable message. example: Access denied code: type: string description: >- Machine-readable reason. Present on the failures that define one, absent otherwise. responses: Unauthorized: description: 'No usable credential. Send `Authorization: Bearer $ORGO_API_KEY`.' content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalid-key: summary: The key is not one of yours value: error: Invalid API key no-credential: summary: No key and no session value: error: Authentication required TrialInactive: description: >- The computer is a free trial computer whose trial is no longer active, or it is paid for by its own subscription or dedicated purchase and that payment has lapsed. content: application/json: schema: $ref: '#/components/schemas/Error' examples: trial: summary: Trial no longer active value: error: Choose a plan to continue. payment: summary: The computer's own payment has lapsed value: error: Manage this computer’s payment in Account → Usage. AccessDenied: description: >- You are not the owner or a member of the computer's workspace, you have view-only access, or the API key is scoped to another workspace. content: application/json: schema: $ref: '#/components/schemas/Error' examples: no-access: summary: Not the owner or a member of the workspace value: error: You do not have access to this workspace. view-only: summary: View-only member, and the request changes something value: error: >- This workspace is view-only. Ask the owner for write access (workspace_read_only). scope-mismatch: summary: The API key is scoped to another workspace value: error: >- This API key cannot access this workspace (workspace_scope_mismatch). AuthUnavailable: description: >- Orgo could not verify the credential because of a server-side fault, such as a database outage. Retry after `Retry-After`. Do not rotate the key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: >- Service temporarily unavailable. The database is not accepting requests. Retry shortly. headers: Retry-After: description: Seconds to wait before retrying. Always `5`. schema: type: string example: '5' securitySchemes: bearerAuth: type: http scheme: bearer description: API key authentication. Get your key at orgo.ai/workspaces ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.