v44

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

Drag the mouse along a path

Press and hold a mouse button, optionally wait for a short delay, then move along the given path and release. The path is a list of [x, y] coordinate pairs.

post/computer/drag_mouse

Request body

button'left' | 'middle' | 'right'

Mouse button to drag with

delayinteger

Delay in milliseconds between button down and starting to move along the path.

steps_per_segmentinteger

Number of relative move steps per segment in the path. Ignored when smooth=true. Minimum 1.

step_delay_msinteger

Delay in milliseconds between relative steps while dragging. Ignored when smooth=true.

smoothboolean

Use human-like Bezier curves between path waypoints instead of linear interpolation. When true, steps_per_segment and step_delay_ms are ignored.

duration_msinteger

Target total duration in milliseconds for the entire drag movement when smooth=true. Omit for automatic timing based on total path length.

hold_keysstring[]

Modifier keys to hold during the drag

Response

Drag performed