---
title: "Changes to List task runs"
method: GET
path: "/v2/tasks/{task_id}/runs"
---

# Changes to List task runs

`GET /v2/tasks/{task_id}/runs`

> Every recorded change to this operation, newest first.
> 48 revisions in range; 1 not diffed.

## Timeline

Changed in 1 of 48 revisions.

- **2026-08-06** `4f94eb2fd1ab`: 5 breaking, 5 warning, 13 info

## Changes

- **2026-08-06** `4f94eb2fd1ab`: 5 breaking, 5 warning, 13 info
  - removed the enum value `cancelled` from the `query` request parameter `status`
  - removed the enum value `completed` from the `query` request parameter `status`
  - removed the enum value `failed` from the `query` request parameter `status`
  - removed the enum value `pending` from the `query` request parameter `status`
  - removed the enum value `running` from the `query` request parameter `status`
  - added the new `CANCELLED` enum value to the `task_runs/items/status` response property for the response status `200`
  - added the new `COMPLETED` enum value to the `task_runs/items/status` response property for the response status `200`
  - added the new `FAILED` enum value to the `task_runs/items/status` response property for the response status `200`
  - added the new `PENDING` enum value to the `task_runs/items/status` response property for the response status `200`
  - added the new `RUNNING` enum value to the `task_runs/items/status` response property for the response status `200`
  - api operation id `tasks_list_runs` removed and replaced with `list_task_runs`
  - added the new enum value `CANCELLED` to the `query` request parameter `status`
  - added the new enum value `COMPLETED` to the `query` request parameter `status`
  - added the new enum value `FAILED` to the `query` request parameter `status`
  - added the new enum value `PENDING` to the `query` request parameter `status`
  - added the new enum value `RUNNING` to the `query` request parameter `status`
  - added the optional property `task_runs/items/experiment_id` to the response with the `200` status
  - added the optional property `task_runs/items/failure_reason` to the response with the `200` status
  - removed the `cancelled` enum value from the `task_runs/items/status` response property for the response status `200`
  - removed the `completed` enum value from the `task_runs/items/status` response property for the response status `200`
  - removed the `failed` enum value from the `task_runs/items/status` response property for the response status `200`
  - removed the `pending` enum value from the `task_runs/items/status` response property for the response status `200`
  - removed the `running` enum value from the `task_runs/items/status` response property for the response status `200`

---

[Operation](https://skmtc.dev/arize-ai/apis/arize-rest-api/docs/v2/tasks/:task_id/runs/get.md) - [API](https://skmtc.dev/arize-ai/apis/arize-rest-api.md) - [Page](https://skmtc.dev/arize-ai/apis/arize-rest-api/changes/v2/tasks/:task_id/runs/get)