Skip to content

Desktops · 7 November 2026

Capture the screen with POST /v2/desktops/{id}:screenshot and drive it with POST /v2/desktops/{id}:act

A screenshot returns the whole screen as base64, as png or jpeg (set quality, 1 to 100), with its width and height. An action moves, clicks, drags or scrolls the mouse by pixel, types text, presses xdotool key names such as ctrl+l or Return, reads the cursor position, lists the windows and focuses one, opens a URL in the desktop's Chromium, or launches a program. Both run inside the desktop's own sandbox. Returns 400 (invalid_request) when a field is outside its limits, 409 (desktop_not_running) when the desktop is not running, and 409 (desktop_failed) with the command's own error when it fails. Available in every SDK as desktops.screenshot and desktops.act.

Same day.

Cut your cloud billby 75%.

No card to start. Billed by the second after.

Start free, no card