Orgo - Cloud computers for AI agents

POST

computers

{id}

click

curl --request POST \
  --url https://www.orgo.ai/api/computers/{id}/click \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "x": 100,
  "y": 200
}
'

{
  "success": true
}

Moves the pointer to the given coordinates and clicks there.

Path parameters

string

required

Computer ID (UUID).

Query parameters

string

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

Body parameters

integer

required

X coordinate, in pixels from the left edge. Omitting it is not rejected. The click lands at 0.

integer

required

Y coordinate, in pixels from the top edge. Omitting it is not rejected. The click lands at 0.

string

default:"left"

Which button to press: left, right, or middle. Any other value falls back to left without an error.

boolean

default:"false"

Double-click instead of single-clicking. double always uses the left button, so button has no effect when it is set. The response still echoes the button you sent.

string[]

Keys held down for the duration of the click: shift to extend a selection, ctrl to add to one. Optional; omit for a plain click. One to four of ctrl (alias control), alt (alias option), shift, and super (aliases cmd, meta, win). An unrecognised name rejects the whole request rather than dropping one modifier and performing a different gesture. Cannot be combined with double or with repeat above 1.

integer

default:"1"

Number of clicks in rapid succession, so 3 is a triple-click. Optional; 1 through 10. Values of 1 or below behave as a single click. The repeat is counted on the computer, so the gap between presses stays under the toolkit’s multi-click threshold no matter how slow the network is. Cannot be combined with modifiers.

Response

boolean

Always true on a 200. A refused or failed click is an error status.

string

double_click when double was set, click otherwise.

object

Echo of what was performed. Always carries x, y, and button. A plain click adds double: false; a repeat click adds repeat; a modified click adds modifiers with the names normalised (option comes back as alt).

Example

# Left click at (100, 200)
curl -X POST https://www.orgo.ai/api/computers/$COMPUTER_ID/click \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x": 100, "y": 200}'

# Right click
curl -X POST https://www.orgo.ai/api/computers/$COMPUTER_ID/click \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x": 100, "y": 200, "button": "right"}'

# Double click
curl -X POST https://www.orgo.ai/api/computers/$COMPUTER_ID/click \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x": 100, "y": 200, "double": true}'

# Shift-click to extend a selection
curl -X POST https://www.orgo.ai/api/computers/$COMPUTER_ID/click \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x": 100, "y": 200, "modifiers": ["shift"]}'

# Triple click to select a line
curl -X POST https://www.orgo.ai/api/computers/$COMPUTER_ID/click \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x": 100, "y": 200, "repeat": 3}'

import requests

url = f"https://www.orgo.ai/api/computers/{computer_id}/click"
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}

# Left click
requests.post(url, headers=headers, json={"x": 100, "y": 200})

# Right click
requests.post(url, headers=headers, json={"x": 100, "y": 200, "button": "right"})

# Double click
requests.post(url, headers=headers, json={"x": 100, "y": 200, "double": True})

# Ctrl-click to add to a selection
requests.post(url, headers=headers, json={"x": 100, "y": 200, "modifiers": ["ctrl"]})

# Triple click
requests.post(url, headers=headers, json={"x": 100, "y": 200, "repeat": 3})

const url = `https://www.orgo.ai/api/computers/${computerId}/click`;
const headers = {
  'Authorization': `Bearer ${apiKey}`,
  'Content-Type': 'application/json'
};

// Left click
await fetch(url, { method: 'POST', headers, body: JSON.stringify({ x: 100, y: 200 }) });

// Right click
await fetch(url, { method: 'POST', headers, body: JSON.stringify({ x: 100, y: 200, button: 'right' }) });

// Ctrl-click to add to a selection
await fetch(url, { method: 'POST', headers, body: JSON.stringify({ x: 100, y: 200, modifiers: ['ctrl'] }) });

// Triple click
await fetch(url, { method: 'POST', headers, body: JSON.stringify({ x: 100, y: 200, repeat: 3 }) });

Response

{
  "success": true,
  "action": "click",
  "details": { "x": 100, "y": 200, "button": "left", "double": false }
}

Errors

Status	Meaning
`400`	The computer has no VM attached: `{"error": "Desktop instance not available"}`. Also returned by the computer agent for `modifiers` combined with `double` or `repeat` above 1, for `repeat` above 10, for an unrecognised modifier name, for more than four modifiers, and when a body field has the wrong JSON type, such as `x` sent as a string rather than a number.
`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 computer agent could not perform the click, 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": "double cannot be combined with modifiers",
  "request_id": "9f2b7c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
  "upstream_status": 400
}

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.

Body

application/json

integer

required

X coordinate

Required range: x >= 0

integer

required

Y coordinate

Required range: x >= 0

button

enum<string>

default:left

Which button to press. Any other value falls back to left without an error.

Available options:

left,

right,

middle

double

boolean

default:false

Double-click instead of single-clicking. A double-click always uses the left button, so button has no effect when this is set. The response still echoes the button you sent.

modifiers

enum<string>[]

Keys held down for the duration of the click. Use shift to extend a selection, ctrl to add to one. Optional: omit for a plain click. One to four of ctrl (alias control), alt (alias option), shift, and super (aliases cmd, meta, win). An unrecognised name rejects the whole request rather than dropping one modifier and performing a different gesture. Cannot be combined with double or with repeat above 1. The response echoes the names normalised, so option comes back as alt.

Required array length: 1 - 4 elements

Available options:

ctrl,

control,

alt,

option,

shift,

super,

cmd,

meta,

win

repeat

integer

default:1

Number of clicks in rapid succession, so 3 is a triple-click. Optional. Values of 1 or below behave as a single click, and a value above 10 is refused with 400. The repeat is counted on the computer, so the gap between presses stays under the toolkit's multi-click threshold no matter how slow the network is. Cannot be combined with modifiers.

Required range: 1 <= x <= 10

Response

Click performed

success

boolean

Example:

true

curl --request POST \
  --url https://www.orgo.ai/api/computers/{id}/click \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "x": 100,
  "y": 200
}
'

{
  "success": true
}

Overview

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Click mouse

Path parameters

Query parameters

Body parameters

Response

Example

Response

Errors

Authorizations

Path Parameters

Query Parameters

Body

Response

​Path parameters

​Query parameters

​Body parameters

​Response

​Example

​Response

​Errors

Authorizations

Path Parameters

Query Parameters

Body

Response

Path parameters

Query parameters

Body parameters

Response

Example

Response

Errors