Actions
Drag mouse
Press the left button at one coordinate, move, and release at another.
POST
Drag mouse
Presses the left mouse button at the start coordinate, moves to the end coordinate, and releases. The drag is one continuous motion; there is no way to set its speed, and on Linux the button is always the left one.
On a Windows computer the response is
{"ok": true}, an optional button field (left, right, or middle) picks the button, and ?screen= is ignored.Path parameters
Query parameters
Which screen to drag 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
All four coordinates are required, and each must be a non-negative integer.0 is a valid coordinate. A missing, negative, or non-integer coordinate returns 400.
Response
Example
Response
Errors
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.
Authorizations
Query Parameters
Body
application/json
On Linux the drag always uses the left button. There is no speed setting. Each coordinate must be a non-negative integer: 0 is a valid coordinate, and a missing, negative, or non-integer coordinate is rejected with 400.
Response
Drag performed