Operations
Work that takes longer than one call.
Get an operation
Needs the read permission. Answers within 28 s.
Status of create, start, stop, restart or delete. Pass wait_s to hold the reply until it changes. Long polls are served from in-memory events, never by polling the database or the host.
path Parameters
operation_id^op_[0-9a-z]{20}$ · requiredOperation id (op_...).
query Parameters
wait_sLong poll: hold the reply up to this many seconds until something changes. 0 answers at once. Capped at 25 so every call ends within 30 s.
Get an operation › Responses
Success.
id^op_[0-9a-z]{20}$ · requiredreconciling: the outcome is uncertain and we are checking the host. Not a failure; do not retry.
screen_id^scr_[0-9a-z]{20}$ · requiredcreated_atupdated_atList a screen's operations
Needs the read permission. Answers within 2 s.
The screen's operations (create, start, stop, restart, delete, restore, convert, snapshot, reset and template saves), newest first, finished ones included. Kept 30 days.
path Parameters
screen_id^scr_[0-9a-z]{20}$ · requiredScreen id (scr_...).
query Parameters
limitPage size, 1 to 100.
after^[A-Za-z0-9_-]+$Opaque cursor from the previous page's next.
Headers
Kubi-Run^[ -~]{1,100}$Optional label that groups calls into one run in the screen's history. It is only a label and never locks the screen. The SDK fills it from KUBI_RUN, else Claude Code's CLAUDE_CODE_SESSION_ID, else one id per client it creates.
List a screen's operations › Responses
Success.