---
title: "Read live program log chunks"
method: GET
path: "/v1/workloads/{id}/logs/live"
---

# Read live program log chunks

`GET /v1/workloads/{id}/logs/live`

## Request

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

Distributed member logs use a cursor bound to their group and member. Each response is byte-bounded. Expired closed groups return an empty page with truncated and expired set. Active groups retain logs during cleanup. The group shares an 8 MiB live log allowance.

## Path parameters

- `id` string, required

## Query parameters

- `after` string
- `member_id` string

## Response `200`

Live logs, retained for 24 hours after termination. Capture is bounded to 8 MiB per generation.

- LiveLogPage
  - `chunks` union[], required
    - union
      - object
        - `id` integer, required
        - `stage_id` string, required
        - `generation` integer, required
        - `text` string, required
      - DistributedLogChunk
        - `group_id` string, required
        - `member_id` string, required
        - `node_rank` integer, required
        - `stage_id` string, required
        - `generation` integer, required
        - `offset` integer, required
        - `text` string, required
        - `data_base64` string, byte, required: Exact customer program bytes. Text provides a UTF-8 display representation.
  - `next_cursor` string, required
  - `truncated` boolean, required
  - `group_id` string
  - `member_id` string
  - `expired` boolean

## Other responses

- `404`: Workload not found

## Changes

- **2026-10-01** `9fb5c223db3e`: 5 breaking, 5 info
  - the `chunks/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `chunks/items/generation` from the response with the `200` status
  - removed the required property `chunks/items/id` from the response with the `200` status
  - removed the required property `chunks/items/stage_id` from the response with the `200` status
  - …6 more

[Operation history](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/changes/v1/workloads/:id/logs/live/get.md)

---

[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)