v1
latestOpenAPI 3.1.0MIT2026-08-0481194343.8 KBLong-poll commands for an external machine
DEVICE TOKEN ONLY. Returns commands after an exclusive cursor. Persist next_cursor only after durably processing the batch. A long-poll timeout returns 200 with data=[]; reconnect with the last committed cursor. The server permits exactly one queued or delivered command per external machine; concurrent dispatch returns 409 MACHINE_BUSY, preventing cross-replica races on one physical display. Each command is fenced, deadline-bound, and tied to the frame in precondition_frame_id. A driver must reject expired, stale-fenced, unsupported, or visibly stale commands instead of executing them.
Query parameters
Exclusive durable cursor. Use the previous response's next_cursor to resume without gaps.
Maximum queued commands returned in one batch.
Long-poll duration. A timeout is a 200 response with data=[] and a resumable next_cursor.
Response
Command batch, or an empty data array when the long poll expires.