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

# Changes to List runs

`GET /v1/runs`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 86 revisions.

- **2026-08-29** `b89637d05de9` — 1 info
- **2026-08-13** `0c5e6f1a3df9` — 1 info
- **2026-07-22** `5987635eae7d` — 1 info
- **2026-07-20** `b7fa64d35769` — 1 info
- **2026-07-14** `4aae03aca7da` — 2 info
- **2026-07-12** `3c39ee1fef00` — 1 info
- **2026-06-08** `3a3616091b66` — 1 info

## Changes

- **2026-08-29** `b89637d05de9` — 1 info
  - added the new optional `query` request parameter `failure_category`
- **2026-08-13** `0c5e6f1a3df9` — 1 info
  - added the enum value `task_v3` to the property `anyOf[subschema #1]/items/` of the `query` request parameter `run_type`
- **2026-07-22** `5987635eae7d` — 1 info
  - added the new optional `query` request parameter `workflow_permanent_id`
- **2026-07-20** `b7fa64d35769` — 1 info
  - added the enum value `paused` to the property `anyOf[subschema #1]/items/` of the `query` request parameter `status`
- **2026-07-14** `4aae03aca7da` — 2 info
  - added the new optional `query` request parameter `run_type`
  - added the new optional `query` request parameter `tags`
- **2026-07-12** `3c39ee1fef00` — 1 info
  - added the optional property `items/trigger_type` to the response with the `200` status
- **2026-06-08** `3a3616091b66` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/docs/v1/runs/get.md) · [API](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2.md) · [Page](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/changes/v1/runs/get)