v106

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-02160524464.6 KB
Run Internals

Tail Command Log

Returns a byte-offset slice of a command stage output log. Bytes are base64-encoded and are not snapped to UTF-8 boundaries.

get/api/v1/runs/{id}/stages/{stageId}/logs/output

Path parameters

idstring required

Unique run identifier (ULID).

stageIdstring required

Identifier of a stage within a run's workflow graph, serialized as node_id@visit.

Query parameters

offsetinteger

Byte offset to start reading from. Defaults to 0.

limitinteger

Maximum bytes to return. Defaults to 65536 and is capped at 1048576.

Response

Command log bytes.

offsetinteger required

Actual byte offset used for this slice.

next_offsetinteger required

Byte offset for the next tail request.

total_bytesinteger required

Total bytes currently available for the output log.

bytes_base64string required

Base64-encoded raw log bytes.

eofboolean required

Whether the output log is finalized.

cas_refstring nullable required

Final CAS reference once the command has completed.

live_streamingboolean required

Whether the sandbox provided live output while the command was running.

Example response

{
  "next_offset": 4096,
  "total_bytes": 8192,
  "bytes_base64": "aGVsbG8K",
  "live_streaming": true
}