Orgo - Cloud computers for AI agents

GET

computers

{id}

operations

{operationId}

Get computer operation

curl --request GET \
  --url https://www.orgo.ai/api/computers/{id}/operations/{operationId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://www.orgo.ai/api/computers/{id}/operations/{operationId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.orgo.ai/api/computers/{id}/operations/{operationId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.orgo.ai/api/computers/{id}/operations/{operationId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.orgo.ai/api/computers/{id}/operations/{operationId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/computers/{id}/operations/{operationId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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"
}

Use the poll_url returned by an asynchronous start or 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.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Computer UUID or instance ID.

operationId

string<uuid>

required

Response

Operation state.

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

On success, such as { "success": true }.

error

object | null

On failure: error, code, and status.

created_at

string<date-time>

updated_at

string<date-time>

poll_url

string

Get computer operation

curl --request GET \
  --url https://www.orgo.ai/api/computers/{id}/operations/{operationId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://www.orgo.ai/api/computers/{id}/operations/{operationId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.orgo.ai/api/computers/{id}/operations/{operationId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.orgo.ai/api/computers/{id}/operations/{operationId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.orgo.ai/api/computers/{id}/operations/{operationId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/computers/{id}/operations/{operationId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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"
}

Overview

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Get computer operation

Authorizations

Path Parameters

Response