---
title: "Changes to List Runs"
method: GET
path: "/v1/task-agents/{agent_id}/runs"
---

# Changes to List Runs

`GET /v1/task-agents/{agent_id}/runs`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 55 revisions.

- **2026-08-17** `22c2a2291146` — 1 warning
- **2026-07-20** `d4e4f170f4f4` — 1 breaking, 6 warning, 8 info
- **2026-07-12** `e8a97dc9fce2` — 2 breaking, 1 warning, 9 info
- **2026-07-07** `ebe52c375b71` — 1 breaking
- **2026-06-10** `421a9851d61b` — 1 info

## Changes

- **2026-08-17** `22c2a2291146` — 1 warning
  - added the new `5x-high` enum value to the `items/items/effort` response property for the response status `200`
- **2026-07-20** `d4e4f170f4f4` — 1 breaking, 6 warning, 8 info
  - for the `query` request parameter `limit`, default value was changed from `20` to `100`
  - for the `query` request parameter `limit`, the max was set to `200.00`
  - for the `query` request parameter `limit`, the min was set to `1.00`
  - for the `query` request parameter `offset`, the min was set to `0.00`
  - deleted the `query` request parameter `q`
  - deleted the `query` request parameter `status`
  - removed the optional property `items/items/workspace_id` from the response with the `200` status
  - api operation id `list_runs_api_v2_public_web_search_agents__agent_id__runs_get` removed and replaced with `list_runs_public_v1_api_v1_public_web_search_agents__agent_id__runs_get`
  - endpoint deprecated
  - added `#/components/schemas/TaskRunErrorPublicV1` to the `items/items/error` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/TaskRunError` from the `items/items/error` response property `anyOf` list for the response status `200`
  - the response property `limit` became required for the status `200`
  - the response property `offset` became required for the status `200`
  - the `limit` response's property default value `20` was removed for the status `200`
  - the `offset` response's property default value `0` was removed for the status `200`
- **2026-07-12** `e8a97dc9fce2` — 2 breaking, 1 warning, 9 info
  - for the `path` request parameter `agent_id`, the type/format was changed from `string`/`` to `string`/`uuid`
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - deleted the `cookie` request parameter `token`
  - api operation id `list_runs_v2_web_search_agents__agent_id__runs_get` removed and replaced with `list_runs_api_v2_public_web_search_agents__agent_id__runs_get`
  - api tag `Web Search Agents (public)` added
  - api tag `Web Search Agents` removed
  - added the new optional `query` request parameter `q`
  - added the new optional `query` request parameter `status`
  - added the optional property `limit` to the response with the `200` status
  - added the optional property `offset` to the response with the `200` status
  - added the required property `items` to the response with the `200` status
  - added the required property `total` to the response with the `200` status
- **2026-07-07** `ebe52c375b71` — 1 breaking
  - the `items/web_search_agent_id/anyOf[subschema #1]/` response's property type/format changed from `string`/`uuid` to `string`/`` for status `200`
- **2026-06-10** `421a9851d61b` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/nimbleway/apis/api-gateway/docs/v1/task-agents/:agent_id/runs/get.md) · [API](https://skmtc.dev/nimbleway/apis/api-gateway.md) · [Page](https://skmtc.dev/nimbleway/apis/api-gateway/changes/v1/task-agents/:agent_id/runs/get)