Skip to main content
Orgo API error responses are JSON with an error string. The OpenAI-compatible /v1/chat/completions endpoint is the exception: its error is an object with type, message, and code. When a computer action fails at the desktop, or while Orgo is reaching it, the response also carries a request_id to use when contacting support, and some carry a machine-readable code.
When the error originated on the desktop side of the request, the response also includes the upstream status:
Always include request_id when emailing contact@orgo.ai about a failed call. It maps directly to a server-side log line.

Authentication

Orgo API keys come in two flavors: account-wide (can access every workspace your account can) and workspace-scoped (locked to one workspace and refused everywhere else). Pick the scope when you create the key at orgo.ai/api-keys.

Computer not responding

Action errors (bash, click, type, exec, etc.)

When an action endpoint returns a non-200, the upstream_status field tells you whether the failure came from Orgo’s control plane or from the desktop itself.

Recovering a stuck computer

A computer is “stuck” if it returns 200 on GET /computers/{id} but action calls fail.
  1. GET /computers/{id}/health. It changes nothing, and checks says which part failed, as described in Check computer health.
  2. If overall is not healthy, POST /computers/{id}/heal. It tries to recover the computer without restarting it, and recommendation says what to do next, as described in Heal a computer.
  3. If that does not fix it, POST /computers/{id}/heal with {"action": "restart"}. Files on disk are preserved across a restart; running processes are not.
  4. If restart fails, capture request_ids from a few attempts and email contact@orgo.ai. Do not delete the computer; deletion drops the disk.

Reporting a bug

When something is broken, send:
  • The request_id from the error response (the most important field).
  • The exact request you made (method, URL, body, redacted of secrets).
  • The full error response.
Email: contact@orgo.ai. Discord: discord.gg/tbYGpvnnJD.