---
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-10-07** `42a9cd544e13` — 1 info
  - added the optional property `oneOf[subschema #12: LettaUsageStatistics]/steps_messages/anyOf[subschema #1]/items/items/tool_returns/anyOf[subschema #1]/items/func_response` to the response with the `200` status
- **2025-10-07** `1ba60b114a27` — 1 info
  - added the optional property `oneOf[subschema #12: LettaUsageStatistics]/steps_messages/anyOf[subschema #1]/items/items/tool_returns/anyOf[subschema #1]/items/tool_call_id` to the response with the `200` status
- **2025-10-03** `f0554a0bf8b2` — 5 info
  - added the optional property `oneOf[subschema #12: LettaUsageStatistics]/steps_messages/anyOf[subschema #1]/items/items/content/anyOf[subschema #1]/items/oneOf[subschema #1: TextContent]/signature` to the response with the `200` status
  - added the optional property `oneOf[subschema #12: LettaUsageStatistics]/steps_messages/anyOf[subschema #1]/items/items/content/anyOf[subschema #1]/items/oneOf[subschema #3: ToolCallContent]/signature` to the response with the `200` status
  - added the optional property `oneOf[subschema #12: LettaUsageStatistics]/steps_messages/anyOf[subschema #1]/items/items/content/anyOf[subschema #1]/items/oneOf[subschema #7: OmittedReasoningContent]/signature` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: UserMessage]/content/anyOf[subschema #1]/items/oneOf[subschema #1: TextContent]/signature` to the response with the `200` status
  - …1 more
- …earlier changes not shown

[Full 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/42a9cd544e13/schema)