---
title: "Poll a Start, Stop, restore or Clear and restart"
method: GET
path: "/api/computers/{id}/operations/{operationId}"
tags: ["computers"]
---

# Poll a Start, Stop, restore or Clear and restart

`GET /api/computers/{id}/operations/{operationId}`

## Request

- Base URL: `https://www.orgo.ai`
- URL: `https://www.orgo.ai/api/computers/{id}/operations/{operationId}`
- Auth: HTTP bearer

The poll_url a 202 gave. Poll every Retry-After seconds (2) until status is succeeded, failed or needs_review. succeeded carries result; failed carries error ({ error, code, status, retry_after? }).

## Path parameters

- `id` string, required
- `operationId` string, uuid, required

## Response `200`

The operation.

- ComputerOperation
  - `id` string, uuid, required
  - `desktop_id` string, required
  - `action` 'start' | 'stop' | 'restore' | 'clear_restart', required
  - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'needs_review', required
  - `result` object, nullable
  - `error` object, nullable
    - `error` string
    - `code` string
    - `status` integer
    - `retry_after` number
  - `created_at` string, date-time
  - `poll_url` string, required

## Other responses

- `404`: No such operation on this computer.
- `429`: Over one of the account's rate limits (rate_limited): `limit` names it, `retry_after` and Retry-After say how many seconds to wait. Limits are per account (the workspace owner when the request acts on a computer or a workspace) and set by its plan (x-rate-limits).

## Changes

- **2026-11-01** `60e768a2bb9d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/orgo/apis/orgo-api/changes/api/computers/:id/operations/:operationId/get.md)

---

[API](https://skmtc.dev/orgo/apis/orgo-api.md) - [All operations](https://skmtc.dev/orgo/apis/orgo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orgo/apis/orgo-api/revisions/e4c1e7379fa5?raw)