v44

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0156121143.5 KB

Scroll the mouse wheel at a position on the host computer

Scroll vertically and/or horizontally at the given coordinates, optionally while holding modifier keys. The scroll amounts are in logical ticks (not pixels) and application behavior may vary; tuning may be required. When both horizontal and vertical deltas are provided, the server applies them sequentially (vertical then horizontal) and batches wheel events using xdotool click --repeat N --delay 0 <button>.

post/computer/scroll

Request body

xinteger required

X coordinate at which to perform the scroll

yinteger required

Y coordinate at which to perform the scroll

delta_xinteger

Horizontal scroll amount. Positive scrolls right, negative scrolls left.

delta_yinteger

Vertical scroll amount. Positive scrolls down, negative scrolls up.

hold_keysstring[]

Modifier keys to hold during the scroll

Response

Scroll performed