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

{
  "success": true,
  "image": "<string>",
  "mime_type": "<string>",
  "width": 123,
  "height": 123,
  "metadata": {}
}

Captures the computer’s display. By default it returns a stored image URL. Use response_format=binary for image bytes in the same response, or response_format=base64 for inline JSON. Inline responses skip storage and a second download.

Path parameters

string

required

Computer ID (UUID). An instance_id is not accepted here and fails with 500.

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. A Windows computer ignores this parameter.

string

default:"url"

url, base64, or binary. Binary returns the image with its actual Content-Type. Base64 returns {success, image, mime_type, width, height}, where image is raw base64.

string

png, jpeg, or webp. Omit to preserve the captured format.

integer

default:"80"

An integer from 1 through 100. Applies when the image is re-encoded as JPEG or WebP, which happens when you request a format or a scale below 1.

number

default:"1"

Greater than 0 and at most 1. For example, 0.5 halves both dimensions.

For a smaller response, request ?response_format=binary&format=webp&quality=75&scale=0.5.

URL 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.png. It is not an absolute URL, so join it to the origin before fetching. The path does not expire, but it is not public: fetch it with the same Authorization header, as an account that can view the computer’s workspace. A request without credentials returns 401, and one without access returns 404. A workspace-scoped key cannot fetch it at all (403), so use response_format=base64 or binary with a scoped key.

object

Information about the stored image.

Show metadata fields

string

Screenshot record ID (UUID). It also appears in storage_path, after the timestamp.

string

ISO 8601 creation timestamp.

integer

Size of the stored image in bytes.

string

Object key in storage: <workspace-id>/<timestamp>_<screenshot-id>.<ext>, where the extension is png, jpg, or webp. image is this key served through /api/storage/.

Stored filenames and Content-Type match the encoded image: .png, .jpg, or .webp. Inline responses use Cache-Control: private, no-store.

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 and send the same key.
img = requests.get(
    "https://www.orgo.ai" + data["image"],
    headers={"Authorization": f"Bearer {api_key}"}
)
with open("screenshot.png", "wb") as f:
    f.write(img.content)

import fs from 'node:fs';

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 and send the same key.
const img = await fetch(`https://www.orgo.ai${image}`, {
  headers: { 'Authorization': `Bearer ${apiKey}` }
});
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.png",
  "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.png"
  }
}

Errors

Status	Meaning
`400`	Invalid response format, image format, quality, or scale. Also returned when 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"}`. Access failures also return `401` on this endpoint, not `403`: `{"error": "You do not have access to this workspace."}` when you are neither the owner nor a member of the computer’s workspace, and `{"error": "This API key cannot access this workspace (workspace_scope_mismatch)."}` for a workspace-scoped key used outside its workspace. A server-side fault while verifying the credential also returns `401` here, with `{"error": "Service temporarily unavailable. …"}`. Retry that one; the key is fine.
`402`	The computer was created as a free trial that is no longer active: `{"error": "Choose a plan to continue."}`.
`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.
`503`	The computer could not be reached: `{"error": "Could not reach the desktop. Try again in a moment.", "code": "ECONNREFUSED"}`. Safe to retry. A computer that never finished provisioning also returns `503`, with `{"error": "Computer not ready"}`.

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_format

enum<string>

default:url

How to return the image.

Available options:

url,

base64,

binary

format

enum<string>

Optional output encoding. Omit to preserve the guest encoding.

Available options:

png,

jpeg,

webp

quality

integer

default:80

JPEG/WebP encoding quality. Use with an explicit format.

Required range: 1 <= x <= 100

scale

number

default:1

Image dimensions as a fraction of the source. Coordinates in click/type APIs remain unscaled.

Required range: x <= 1

Response

Screenshot captured

success

boolean

image

string

Stored URL for url mode; raw base64 for base64 mode.

mime_type

string

width

integer

height

integer

metadata

object

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

{
  "success": true,
  "image": "<string>",
  "mime_type": "<string>",
  "width": 123,
  "height": 123,
  "metadata": {}
}

Overview

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Take screenshot

Path parameters

Query parameters

URL response

Example

Response

Errors

Authorizations

Path Parameters

Query Parameters

Response

​Path parameters

​Query parameters

​URL response

​Example

​Response

​Errors

Authorizations

Path Parameters

Query Parameters

Response

Path parameters

Query parameters

URL response

Example

Response

Errors