---
title: "Changes to List Messages"
method: GET
path: "/v1/agents/{agent_id}/messages"
---

# Changes to List Messages

`GET /v1/agents/{agent_id}/messages`

> Every recorded change to this operation, 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** `aa40fdf245f1`: 1 breaking, 4 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** `aa40fdf245f1`: 1 breaking, 4 info
  - for the `query` request parameter `limit`, default value was changed from `10` to `100`
  - added the new optional `query` request parameter `order`
  - added the new optional `query` request parameter `order_by`
  - `query` request parameter `limit` list-of-types was widened by adding types `null`
  - for the `query` request parameter `limit`, the type was generalized from `integer` to no type

---

[Operation](https://skmtc.dev/yu-code666/apis/letta-api/docs/v1/agents/:agent_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/agents/:agent_id/messages/get)