---
title: "Read command output"
method: GET
path: "/v1/sandboxes/{id}/execs/{exec_id}/stream"
tags: ["Sandboxes"]
---

# Read command output

`GET /v1/sandboxes/{id}/execs/{exec_id}/stream`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/sandboxes/{id}/execs/{exec_id}/stream`
- Auth: HTTP bearer

Reads ordered stdout and stderr frames after a sequence cursor. Repeat with next_sequence to stream without losing output.

## Path parameters

- `id` string, required
- `exec_id` string, required

## Query parameters

- `after` integer
- `limit` integer
- `wait` boolean

## Response `200`

Success

- SandboxOutputPage
  - `frames` SandboxOutputFrame[], required
    - `sequence` integer, required
    - `stream` 'stdout' | 'stderr', required
    - `offset` integer, required
    - `data` string, byte, required: Base64 encoded output bytes.
    - `created_at` string, date-time, required
  - `next_sequence` integer, required: Cursor for the next read.
  - `last_sequence` integer, required
  - `final_sequence` integer, nullable
  - `state` 'queued' | 'dispatching' | 'running' | 'completed' | 'failed' | 'cancelled' | 'lost', required
  - `done` boolean, required: True when the execution is terminal.
  - `complete` boolean, required: True when the page reaches the final output sequence without a gap.

## Other responses

- `default`: Error. The code, message, and fix fields describe the rejection and its remedy.

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)