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

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


## 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: 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
      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'
        '401':
          description: >-
            Request could not be completed. The response includes error and may
            include code.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
        '403':
          description: >-
            Request could not be completed. The response includes error and may
            include code.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
        '404':
          description: >-
            Request could not be completed. The response includes error and may
            include code.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
        '500':
          description: >-
            Request could not be completed. The response includes error and may
            include code.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
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
          nullable: true
        error:
          type: object
          nullable: true
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        poll_url:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key authentication. Get your key at orgo.ai/workspaces

````