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
}

{
  "error": "Invalid API key"
}

{
  "error": "Resource not found"
}

Performs a mouse click at the specified coordinates.

Path parameters

string

required

Computer ID (UUID).

Body parameters

integer

required

X coordinate (pixels from left edge).

integer

required

Y coordinate (pixels from top edge).

string

default:"left"

Mouse button: left or right.

boolean

default:"false"

If true, performs a double-click. When double is set, button is ignored.

Response

boolean

true if the click was performed.

string

Action name: click or double_click.

Example

# Left click at (100, 200)
curl -X POST https://www.orgo.ai/api/computers/a3bb189e-8bf9-3888-9912-ace4e6543002/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/a3bb189e-8bf9-3888-9912-ace4e6543002/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/a3bb189e-8bf9-3888-9912-ace4e6543002/click \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x": 100, "y": 200, "double": true}'

import requests

# Left click
requests.post(
    f"https://www.orgo.ai/api/computers/{computer_id}/click",
    headers={"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"},
    json={"x": 100, "y": 200}
)

# Right click
requests.post(
    f"https://www.orgo.ai/api/computers/{computer_id}/click",
    headers={"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"},
    json={"x": 100, "y": 200, "button": "right"}
)

# Double click
requests.post(
    f"https://www.orgo.ai/api/computers/{computer_id}/click",
    headers={"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"},
    json={"x": 100, "y": 200, "double": True}
)

// Left click
await fetch(`https://www.orgo.ai/api/computers/${computerId}/click`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ x: 100, y: 200 })
});

// Right click
await fetch(`https://www.orgo.ai/api/computers/${computerId}/click`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ x: 100, y: 200, button: 'right' })
});

Response

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

Errors

Status	Meaning
`400`	Computer instance not available (not running).
`401`	Missing or invalid API key.
`403`	You do not have access to this computer.
`404`	Computer not found.
`500`	Upstream desktop agent failure.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Computer ID

Body

application/json

integer

required

X coordinate

Required range: x >= 0

integer

required

Y coordinate

Required range: x >= 0

button

enum<string>

default:left

Mouse button

Available options:

left,

right

double

boolean

default:false

Double-click

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
}

{
  "error": "Invalid API key"
}

{
  "error": "Resource not found"
}

Overview

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Files

Templates

Click mouse

Path parameters

Body parameters

Response

Example

Response

Errors

Authorizations

Path Parameters

Body

Response

​Path parameters

​Body parameters

​Response

​Example

​Response

​Errors

Authorizations

Path Parameters

Body

Response

Path parameters

Body parameters

Response

Example

Response

Errors