---
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-08** `b82cbf314740` — 2 info
  - added the optional property `oneOf[subschema #5: ToolCallMessage]/tool_calls` to the response with the `200` status
  - response property `oneOf[subschema #5: ToolCallMessage]/tool_call` deprecated
- **2025-10-08** `1bed3816dfe2` — 6 info
  - added the optional property `oneOf[subschema #6: ToolReturnMessage]/tool_returns` to the response with the `200` status
  - response property `oneOf[subschema #6: ToolReturnMessage]/status` deprecated
  - response property `oneOf[subschema #6: ToolReturnMessage]/stderr` deprecated
  - response property `oneOf[subschema #6: ToolReturnMessage]/stdout` deprecated
  - …2 more
- **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
- …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/6cec99480c13/schema)