v1

latestOpenAPI 3.1.0MIT2026-08-0481194343.8 KB

machines

Capture a screenshot of the machine

Returns raw base64 pixels and decoded dimensions. External-machine responses also return a canonical frame_id; pass that value as the next mutation's precondition_frame_id so changed screens fail closed. A fresh screenshot is a read-only resynchronization operation and advances the external observation frame.

get/v1/machines/{machine_id}/screenshot

Response

Screenshot.

machine_idstring required

image_b64string required

Base64-encoded screenshot (no data: prefix).

mime_typestring required

widthinteger required

heightinteger required

captured_atstring date-time required

frame_idstring uuid nullable

Opaque external-machine observation identity. Bind the next external action to this value with precondition_frame_id; null for managed machines.

request_idstring required