---
title: "Changes to List Runs"
method: GET
path: "/v1/runs/"
---

# Changes to List Runs

`GET /v1/runs/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 36 revisions.

- **2025-10-07** `57161ea6ef83`: 1 info
- **2025-10-01** `2b1d21acfb81`: 1 breaking, 3 info
- **2025-10-01** `d9e4ebe71a8a`: 1 info
- **2025-09-29** `ac8e1eb68404`: 4 warning, 4 info
- **2025-09-18** `3a2d48137c08`: 3 info

## Changes

- **2025-10-07** `57161ea6ef83`: 1 info
  - added the new optional `query` request parameter `statuses`
- **2025-10-01** `2b1d21acfb81`: 1 breaking, 3 info
  - for the `query` request parameter `limit`, default value was changed from `50` to `100`
  - added the new optional `query` request parameter `order`
  - added the new optional `query` request parameter `order_by`
  - `query` request parameter `ascending` was deprecated
- **2025-10-01** `d9e4ebe71a8a`: 1 info
  - `query` request parameter `agent_ids` was deprecated
- **2025-09-29** `ac8e1eb68404`: 4 warning, 4 info
  - removed the optional property `items/created_by_id` from the response with the `200` status
  - removed the optional property `items/job_type` from the response with the `200` status
  - removed the optional property `items/last_updated_by_id` from the response with the `200` status
  - removed the optional property `items/updated_at` from the response with the `200` status
  - the response property `items/agent_id` became required for the status `200`
  - removed the `expired` enum value from the `items/status` response property for the response status `200`
  - removed the `pending` enum value from the `items/status` response property for the response status `200`
  - response property `items/agent_id` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
- **2025-09-18** `3a2d48137c08`: 3 info
  - added the new optional `query` request parameter `agent_id`
  - added the optional property `items/agent_id` to the response with the `200` status
  - added the optional property `items/background` to the response with the `200` status

---

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