Skip to main content
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
}
Performs a mouse click at the specified coordinates.

​
Path parameters

​
id
string
required
Computer ID (UUID).

​
Body parameters

​
x
integer
required
X coordinate (pixels from left edge).
​
y
integer
required
Y coordinate (pixels from top edge).
​
button
string
default:"left"
Mouse button: left or right.
​
double
boolean
default:"false"
If true, performs a double-click. When double is set, button is ignored.

​
Response

​
success
boolean
true if the click was performed.
​
action
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}'

​
Response

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

​
Errors

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

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

Computer ID

Body

application/json
​
x
integer
required

X coordinate

Required range: x >= 0
​
y
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