Actions
Move mouse
Move the pointer without pressing a button, to hover over menus, tooltips, and link previews.
POST
Move mouse
Moves the pointer to the given coordinates without pressing a button. Use it to hover: to open a menu that appears under the pointer, a tooltip, a link preview, or a toolbar that shows only on hover. Click and drag also move the pointer, but both press a button. To see what the hover opened, take a screenshot afterwards.
This endpoint moves the pointer. To move a computer to another workspace, use Move computer.
On a Windows computer the response is
{"ok": true} and ?screen= is ignored. A coordinate above 100000 is refused with 400, and the error body reads Request failed with status code 400 rather than saying why.Path parameters
Query parameters
Which screen to move the pointer on. Optional.
Omit it to act on the screen the computer booted with. Each screen has its own
pointer, so the pointer on every other screen stays where it is. An unknown id
returns
404 rather than falling back to the default screen.Body parameters
Both coordinates are required and must be non-negative integers. A missing, negative, fractional, or non-numeric value, or a body that is not JSON, returns400 before the computer is contacted. Any other field in the body is ignored.
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
Where to move the pointer. Both coordinates are required non-negative integers; anything else returns 400. Any other field is ignored.
Response
Pointer moved