Sandbox

Read bounded observed process output

Read retained stdout and stderr chunks for a processID returned by processes.list. Praxis observation, not complete provider history. Only a witnessed exit event establishes exitCode; disconnects and restarts leave gaps and unknown state. Output retains at most 1 MiB/1024 chunks per process and 4 MiB/4096 chunks per instance across 256 observations. Truncation is explicit. Output data is base64; timestamps are Unix milliseconds. Reading never resumes a paused sandbox.

Call Create sandbox first and replace sbx_123 with its returned sandboxID.

GET /sandbox/v1/sandboxes/{sandboxID}/processes/{processID}/output● Supported

Request parameters

  • sandboxIDstring必填

    path: Sandbox ID.

  • processIDstring必填

    path: The processId returned by List processes.

Returns

200

Errors follow the E2B format — see error codes

Response

HTTP 200

Bounded observation with explicit completeness

application/json

NameTypeDescription
chunksarray<object>Retained output chunks of the process, oldest first.
chunks[].seqintegerSequence number of the chunk; it increases with time and orders chunks.
chunks[].streamstringWhich stream the chunk came from.
chunks[].datastringOutput bytes of the chunk, base64 encoded.
chunks[].timestampnumberTime at which the chunk was recorded, in Unix milliseconds.
completebooleanTrue when the output is whole: the exit was witnessed, no gap occurred and nothing was truncated.
gapbooleanTrue when observation was interrupted, so chunks or the exit may be missing.
truncatedbooleanTrue when old chunks were dropped to stay within the retention limits.
exitCodeinteger | nullExit code of the process; null until an exit was witnessed.