---
title: "Changes to List Eval Runs"
method: GET
path: "/v2/eval-runs"
---

# Changes to List Eval Runs

`GET /v2/eval-runs`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 13 of 25 revisions.

- **2025-11-20** `0cb64ef11adf` — 2 breaking
- **2025-11-19** `cd49adceebf8` — 2 info
- **2025-11-19** `0b43b7bedf32` — 2 info
- **2025-11-17** `1af31c95d91a` — 1 breaking, 2 info
- **2025-11-16** `d950d722e230` — 2 info
- **2025-11-13** `9f42371cf19a` — 4 info
- **2025-11-04** `33b4b8e9d2ce` — 2 info
- **2025-11-03** `b824d75fc3cb` — 1 info
- **2025-10-29** `9b529d67a7d0` — 11 warning, 5 info
- **2025-05-06** `39873621da54` — 5 info
- **2025-05-05** `13afcad941fd` — 2 breaking
- **2025-04-21** `934bf6ad4a6b` — 1 info
- **2025-04-21** `4948fe9c3752` — 2 info

## Changes

- **2025-11-20** `0cb64ef11adf` — 2 breaking
  - removed the required property `items/items/evaluation/anyOf[subschema #1: Eval]/ai_instructions/anyOf[subschema #2: AgentInstructions]/tools/oneOf[subschema #1: ToolArray]/value/items/id` from the response with the `200` status
  - removed the required property `items/items/evaluation/anyOf[subschema #1: Eval]/ai_instructions/anyOf[subschema #3: WorkflowInstructions]/instructions/items/tools/oneOf[subschema #1: ToolArray]/value/items/id` from the response with the `200` status
- **2025-11-19** `cd49adceebf8` — 2 info
  - added `subschema #1, subschema #4` to the `items/items/evaluation/anyOf[subschema #1: Eval]/ai_instructions` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #4` from the `items/items/evaluation/anyOf[subschema #1: Eval]/ai_instructions` response property `anyOf` list for the response status `200`
- **2025-11-19** `0b43b7bedf32` — 2 info
  - added the optional property `items/items/evaluation/anyOf[subschema #1: Eval]/ai_instructions/anyOf[subschema #2: AgentInstructions]/agent_name` to the response with the `200` status
  - added `#/components/schemas/WorkflowInstructions` to the `items/items/evaluation/anyOf[subschema #1: Eval]/ai_instructions` response property `anyOf` list for the response status `200`
- **2025-11-17** `1af31c95d91a` — 1 breaking, 2 info
  - added `#/components/schemas/ToolArray, #/components/schemas/ToolDict, #/components/schemas/ToolString` to the `items/items/evaluation/anyOf[subschema #1: Eval]/ai_instructions/anyOf[subschema #2: AgentInstructions]/tools` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/ToolsList, #/components/schemas/ToolDict, #/components/schemas/ToolsString` from the `items/items/evaluation/anyOf[subschema #1: Eval]/ai_instructions/anyOf[subschema #2: AgentInstructions]/tools` response property `anyOf` list for the response status `200`
  - added discriminator to `items/items/evaluation/anyOf[subschema #1: Eval]/ai_instructions/anyOf[subschema #2: AgentInstructions]/tools` response property for the response status `200`
- **2025-11-16** `d950d722e230` — 2 info
  - added `subschema #1, subschema #3` to the `items/items/evaluation/anyOf[subschema #1: Eval]/ai_instructions/anyOf[subschema #2: AgentInstructions]/tools` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #3` from the `items/items/evaluation/anyOf[subschema #1: Eval]/ai_instructions/anyOf[subschema #2: AgentInstructions]/tools` response property `anyOf` list for the response status `200`
- **2025-11-13** `9f42371cf19a` — 4 info
  - added the optional property `items/items/responses/anyOf[subschema #1]/items/manually_updated` to the response with the `200` status
  - added the optional property `items/items/responses/anyOf[subschema #1]/items/manually_updated_at` to the response with the `200` status
  - added the optional property `items/items/responses/anyOf[subschema #1]/items/manually_updated_by` to the response with the `200` status
  - added the optional property `items/items/responses/anyOf[subschema #1]/items/update_history` to the response with the `200` status
- **2025-11-04** `33b4b8e9d2ce` — 2 info
  - added `subschema #1` to the `items/items/evaluation/anyOf[subschema #1: Eval]/ai_instructions/anyOf[subschema #2: AgentInstructions]/tools` response property `anyOf` list for the response status `200`
  - removed `subschema #2` from the `items/items/evaluation/anyOf[subschema #1: Eval]/ai_instructions/anyOf[subschema #2: AgentInstructions]/tools` response property `anyOf` list for the response status `200`
- **2025-11-03** `b824d75fc3cb` — 1 info
  - added `#/components/schemas/AgentInstructions` to the `items/items/evaluation/anyOf[subschema #1: Eval]/ai_instructions` response property `anyOf` list for the response status `200`
- **2025-10-29** `9b529d67a7d0` — 11 warning, 5 info
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `400`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `401`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `403`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `404`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `409`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `422`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `429`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `500`
  - added the new `auth.workspace_required` enum value to the `error/code` response property for the response status `503`
  - added the new `video` enum value to the `items/items/evaluation/anyOf[subschema #1: Eval]/modality/allOf[subschema #1: ContentType]/` response property for the response status `200`
  - added the new `video` enum value to the `items/items/responses/anyOf[subschema #1]/items/content_type/allOf[subschema #1: ContentType]/` response property for the response status `200`
  - added the optional property `items/items/eval_run_examples` to the response with the `200` status
  - added the optional property `items/items/evaluation/anyOf[subschema #1: Eval]/created_by` to the response with the `200` status
  - added the optional property `items/items/evaluation/anyOf[subschema #1: Eval]/ground_truth/anyOf[subschema #2: FileReference]/file_uuid` to the response with the `200` status
  - added the optional property `items/items/is_sandbox` to the response with the `200` status
  - added the optional property `items/items/responses/anyOf[subschema #1]/items/content/anyOf[subschema #2: FileReference]/file_uuid` to the response with the `200` status
- **2025-05-06** `39873621da54` — 5 info
  - the `num_prompts` response's property default value changed from `50` to `100` for the status `200`
  - removed the `audio` enum value from the `items/items/evaluation/anyOf[subschema #1: Eval]/modality/allOf[subschema #1: ContentType]/` response property for the response status `200`
  - removed the `audio` enum value from the `items/items/responses/anyOf[subschema #1]/items/content_type/allOf[subschema #1: ContentType]/` response property for the response status `200`
  - removed the `video` enum value from the `items/items/evaluation/anyOf[subschema #1: Eval]/modality/allOf[subschema #1: ContentType]/` response property for the response status `200`
  - removed the `video` enum value from the `items/items/responses/anyOf[subschema #1]/items/content_type/allOf[subschema #1: ContentType]/` response property for the response status `200`
- **2025-05-05** `13afcad941fd` — 2 breaking
  - the response property `items/items/evaluation/anyOf[subschema #1: Eval]/name` became optional for the status `200`
  - response property `items/items/evaluation/anyOf[subschema #1: Eval]/name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2025-04-21** `934bf6ad4a6b` — 1 info
  - added the optional property `items/items/evaluation/anyOf[subschema #1: Eval]/ground_truth` to the response with the `200` status
- **2025-04-21** `4948fe9c3752` — 2 info
  - added the optional property `items/items/name` to the response with the `200` status
  - added the required property `items/items/eval_uuid` to the response with the `200` status

---

[Operation](https://skmtc.dev/aymara-ai/apis/aymara-api/docs/v2/eval-runs/get.md) · [API](https://skmtc.dev/aymara-ai/apis/aymara-api.md) · [Page](https://skmtc.dev/aymara-ai/apis/aymara-api/changes/v2/eval-runs/get)
