Orgo - Cloud computers for AI agents

GET

computers

{id}

screenshot

Take screenshot

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

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

fetch('https://www.orgo.ai/api/computers/{id}/screenshot', 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}/screenshot",
  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}/screenshot"

	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}/screenshot")

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

{
  "image": "/api/storage/<workspace-id>/2026-08-05T05-51-55-743Z_<uuid>.jpg"
}

Captures the computer’s display, uploads the image to storage, and returns a path you can fetch.

Path parameters

string

required

Computer ID (UUID).

Query parameters

string

Which screen to capture. Optional. Omit it to capture the screen the computer booted with. An unknown id returns 404 rather than falling back to the default screen.

Response

boolean

Always true on a 200. A failed capture is an error status, not success: false.

string

Path to the stored image, relative to https://www.orgo.ai. For example: /api/storage/4d96f9a0-1c2b-4f3e-9a7d-8b5c6e0f1a2d/2026-04-20T12-00-00-000Z_9f2b7c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d.jpg. It is not an absolute URL, so join it to the origin before fetching. The path does not expire and is served without authentication. The key itself is the capability, so treat it as a secret.

object

Information about the stored image.

Show metadata fields

string

Screenshot record ID (UUID). Also the last path segment of storage_path.

string

ISO 8601 creation timestamp.

integer

Size of the stored image in bytes.

string

Object key in storage: <workspace-id>/<timestamp>_<screenshot-id>.jpg. image is this key served through /api/storage/.

The object is stored under a .jpg key and served as image/jpeg, but the computer agent captures PNG. Detect the format from the bytes rather than from the extension or the content type.

Example

curl https://www.orgo.ai/api/computers/$COMPUTER_ID/screenshot \
  -H "Authorization: Bearer $ORGO_API_KEY"

import requests

response = requests.get(
    f"https://www.orgo.ai/api/computers/{computer_id}/screenshot",
    headers={"Authorization": f"Bearer {api_key}"}
)

data = response.json()

# `image` is relative. Join it to the origin.
img = requests.get("https://www.orgo.ai" + data["image"])
with open("screenshot.png", "wb") as f:
    f.write(img.content)

const response = await fetch(`https://www.orgo.ai/api/computers/${computerId}/screenshot`, {
  headers: { 'Authorization': `Bearer ${apiKey}` }
});

const { image } = await response.json();

// `image` is relative. Join it to the origin.
const img = await fetch(`https://www.orgo.ai${image}`);
const buffer = Buffer.from(await img.arrayBuffer());
fs.writeFileSync('screenshot.png', buffer);

Response

{
  "success": true,
  "image": "/api/storage/4d96f9a0-1c2b-4f3e-9a7d-8b5c6e0f1a2d/2026-04-20T12-00-00-000Z_9f2b7c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d.jpg",
  "metadata": {
    "id": "9f2b7c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "timestamp": "2026-04-20T12:00:00.000Z",
    "size": 187342,
    "storage_path": "4d96f9a0-1c2b-4f3e-9a7d-8b5c6e0f1a2d/2026-04-20T12-00-00-000Z_9f2b7c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d.jpg"
  }
}

Errors

Status	Meaning
`400`	The computer has no VM attached: `{"error": "Desktop instance not available"}`. Start it first.
`401`	Invalid API key: `{"error": "Invalid API key"}`. A request with no `Authorization` header returns `{"error": "Authentication required"}`.
`403`	You are neither the owner nor a member of the computer’s workspace: `{"error": "Access denied"}`. A workspace-scoped key used outside its workspace returns `code: "workspace_scope_mismatch"` instead.
`404`	No computer with this id: `{"error": "Desktop not found"}`. Also returned when `?screen=` names a screen this computer does not have.
`500`	The capture or the upload failed, or the computer never finished provisioning: `{"error": "Computer not ready"}`.
`503`	The computer could not be reached: `{"error": "Could not reach the desktop. Try again in a moment.", "code": "ECONNREFUSED"}`. Safe to retry.

Every failure raised after the request leaves the API layer also carries a request_id. Quote it in support requests. When the computer agent itself answered non-2xx, the body additionally carries upstream_status.

{
  "error": "Could not reach the desktop. Try again in a moment.",
  "request_id": "9f2b7c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
  "code": "ECONNREFUSED"
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Computer ID

Query Parameters

screen

string

Which screen to act on. Omit for the boot screen. An unknown id returns 404 rather than falling back.

Response

Screenshot captured

image

string

URL of the captured image, usually a path relative to the API origin. Fetch it to get the bytes.

Take screenshot

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

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

fetch('https://www.orgo.ai/api/computers/{id}/screenshot', 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}/screenshot",
  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}/screenshot"

	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}/screenshot")

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

{
  "image": "/api/storage/<workspace-id>/2026-08-05T05-51-55-743Z_<uuid>.jpg"
}

Overview

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Take screenshot

Path parameters

Query parameters

Response

Example

Response

Errors

Authorizations

Path Parameters

Query Parameters

Response

​Path parameters

​Query parameters

​Response

​Example

​Response

​Errors

Authorizations

Path Parameters

Query Parameters

Response

Path parameters

Query parameters

Response

Example

Response

Errors