---
title: "Retrieve Stream"
method: POST
path: "/v1/runs/{run_id}/stream"
tags: ["runs"]
---

# Retrieve Stream

`POST /v1/runs/{run_id}/stream`

## Path parameters

- `run_id` string, required

## Request body

- RetrieveStreamRequest
  - `starting_after` integer — Sequence id to use as a cursor for pagination. Response will start streaming after this chunk sequence id
  - `include_pings` boolean, nullable — Whether to include periodic keepalive ping messages in the stream to prevent connection timeouts.
  - `poll_interval` number, nullable — Seconds to wait between polls when no new data.
  - `batch_size` integer, nullable — Number of entries to read per batch.

## Response `200`

Successful response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2025-09-29** `ac8e1eb68404` — 1 info
  - added the optional property `oneOf[subschema #12: LettaUsageStatistics]/steps_messages/anyOf[subschema #1]/items/items/run_id` to the response with the `200` status
- **2025-09-24** `68c3c741b873` — 1 breaking, 1 info
  - added `#/components/schemas/SummarizedReasoningContent` to the `oneOf[subschema #12: LettaUsageStatistics]/steps_messages/anyOf[subschema #1]/items/items/content/anyOf[subschema #1]/items/` response property `oneOf` list for the response status `200`
  - added `summarized_reasoning` discriminator mapping keys to the `oneOf[subschema #12: LettaUsageStatistics]/steps_messages/anyOf[subschema #1]/items/items/content/anyOf[subschema #1]/items/` response property for the response status `200`

[Change history](https://skmtc.dev/yu-code666/apis/letta-api/changes/v1/runs/:run_id/stream/post.md)

---

[API](https://skmtc.dev/yu-code666/apis/letta-api.md) · [All operations](https://skmtc.dev/yu-code666/apis/letta-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yu-code666/letta-api/revisions/9a2ea9530ef9/schema)