Skip to main content
POST
/
computers
/
{id}
/
scroll
Scroll
curl --request POST \
  --url https://www.orgo.ai/api/computers/{id}/scroll \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "direction": "down",
  "amount": 3
}
'
{
  "success": true
}
Scrolls the mouse wheel up or down at the cursor’s current position (or at x, y if provided).

​
Path parameters

​
id
string
required
Computer ID (UUID).

​
Body parameters

​
direction
string
default:"down"
Scroll direction: up or down.
​
amount
integer
default:"1"
Number of scroll clicks.
​
x
integer
Optional X coordinate to move the cursor to before scrolling.
​
y
integer
Optional Y coordinate to move the cursor to before scrolling.

​
Response

​
success
boolean
true if the scroll was performed.
​
action
string
Always scroll.

​
Example

# Scroll down 3 clicks
curl -X POST https://www.orgo.ai/api/computers/a3bb189e-8bf9-3888-9912-ace4e6543002/scroll \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"direction": "down", "amount": 3}'

# Scroll up 10 clicks
curl -X POST https://www.orgo.ai/api/computers/a3bb189e-8bf9-3888-9912-ace4e6543002/scroll \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"direction": "up", "amount": 10}'

​
Response

{
  "success": true,
  "action": "scroll",
  "details": { "direction": "down", "amount": 3 }
}

​
Errors

StatusMeaning
400Computer instance not available.
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
​
direction
enum<string>
required

Scroll direction

Available options:
up,
down
​
amount
integer
default:3

Scroll amount (clicks)

Required range: x >= 1

Response

Scroll performed

​
success
boolean
Example:

true