---
title: "Changes to List Run Messages"
method: GET
path: "/v1/runs/{run_id}/messages"
---

# Changes to List Run Messages

`GET /v1/runs/{run_id}/messages`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 36 revisions.

- **2025-10-08** `b82cbf314740` — 2 info
- **2025-10-08** `1bed3816dfe2` — 6 info
- **2025-10-03** `f0554a0bf8b2` — 2 info
- **2025-10-02** `9a2ea9530ef9` — 1 info

## Changes

- **2025-10-08** `b82cbf314740` — 2 info
  - added the optional property `items/oneOf[subschema #5: ToolCallMessage]/tool_calls` to the response with the `200` status
  - response property `items/oneOf[subschema #5: ToolCallMessage]/tool_call` deprecated
- **2025-10-08** `1bed3816dfe2` — 6 info
  - added the optional property `items/oneOf[subschema #6: ToolReturnMessage]/tool_returns` to the response with the `200` status
  - response property `items/oneOf[subschema #6: ToolReturnMessage]/status` deprecated
  - response property `items/oneOf[subschema #6: ToolReturnMessage]/stderr` deprecated
  - response property `items/oneOf[subschema #6: ToolReturnMessage]/stdout` deprecated
  - response property `items/oneOf[subschema #6: ToolReturnMessage]/tool_call_id` deprecated
  - response property `items/oneOf[subschema #6: ToolReturnMessage]/tool_return` deprecated
- **2025-10-03** `f0554a0bf8b2` — 2 info
  - added the optional property `items/oneOf[subschema #2: UserMessage]/content/anyOf[subschema #1]/items/oneOf[subschema #1: TextContent]/signature` to the response with the `200` status
  - added the optional property `items/oneOf[subschema #7: AssistantMessage]/content/anyOf[subschema #1]/items/oneOf[subschema #1: TextContent]/signature` to the response with the `200` status
- **2025-10-02** `9a2ea9530ef9` — 1 info
  - added the new optional `query` request parameter `order_by`

---

[Operation](https://skmtc.dev/yu-code666/apis/letta-api/docs/v1/runs/:run_id/messages/get.md) · [API](https://skmtc.dev/yu-code666/apis/letta-api.md) · [Page](https://skmtc.dev/yu-code666/apis/letta-api/changes/v1/runs/:run_id/messages/get)