Get command status
Get the status and recent log output of a detached command running in a sandbox. Use tailBytes to limit how much log is returned.
Authorizations
Boat bearer token in the form boat_.... Service API keys authenticate sandbox operations.
Path Parameters
Public Sandbox id returned by create/list/get sandbox calls.
^bx_[23456789abcdefghjkmnpqrstuvwxyz]{8}$Process id returned by a detached command start.
x >= 1Query Parameters
Cap each returned log to its last N bytes. Defaults to 8388608 (8 MiB). Ignored with offsets.
1 <= x <= 8388608Return only stdout written from this byte offset. Use stdoutNextOffset of the previous answer.
x >= 0Return only stderr written from this byte offset. Use stderrNextOffset of the previous answer.
x >= 0Response
Process status and log tails, or the output since the offsets.
true
Stable success envelope discriminator added by v1.
"command.status"lost: the sandbox agent restarted and forgot the process; running/exitCode are then a best-effort probe and the logs come from the on-disk files.
running, exited, lost Tail of the stdout log file. With stdoutOffset: the stdout written since that offset.
Tail of the stderr log file. With stderrOffset: the stderr written since that offset.
Whether the process is still tracked by the sandbox agent.
True when the memory ceiling killed the command or one of its processes and the command failed.
Byte offset where stdout starts: the offset you asked for, or 0 when the log was replaced.
Byte offset where stderr starts: the offset you asked for, or 0 when the log was replaced.
The stdoutOffset for the next read.
The stderrOffset for the next read.
True when more output is already written. Read again at once.