---
title: "Changes to Get an eval run"
method: GET
path: "/evals/{eval_id}/runs/{run_id}"
---

# Changes to Get an eval run

`GET /evals/{eval_id}/runs/{run_id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 10 of 164 revisions.

- **2026-09-25** `d86203de41ae` — 2 info
- **2026-09-16** `2cd8933757a4` — 1 info
- **2026-09-08** `185927e212ab` — 6 warning
- **2026-09-03** `9430b00d75b4` — 5 info
- **2026-08-20** `5de4ab93fa24` — 2 warning
- **2026-08-14** `6ac2618eefd7` — 1 info
- **2026-08-13** `fc45a2f64c0a` — 1 info
- **2026-08-05** `ab0c5306e390` — 2 breaking, 4 warning, 18 info
- **2026-05-13** `74cbcf73838f` — 17 breaking, 4 warning, 20 info
- **2025-04-29** `6a6c681b1820` — 1 info

## Changes

- **2026-09-25** `d86203de41ae` — 2 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
- **2026-09-16** `2cd8933757a4` — 1 info
  - response property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #6: MCP tool]/connector_id` deprecated
- **2026-09-08** `185927e212ab` — 6 warning
  - added the new `gpt-image-2.5-flare` enum value to the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `gpt-image-2.5-flare-2026-09-08` enum value to the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `gpt-image-2.5-sunburst` enum value to the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `gpt-image-2.5-sunburst-2026-09-08` enum value to the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `max` enum value to the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #9: Image generation tool]/quality` response property for the response status `200`
  - added the new `xhigh` enum value to the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #9: Image generation tool]/quality` response property for the response status `200`
- **2026-09-03** `9430b00d75b4` — 5 info
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #12: Custom tool]/async` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #13: Namespace]/tools/items/oneOf[#/components/schemas/FunctionToolParam]/async` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #13: Namespace]/tools/items/oneOf[subschema #2: Custom tool]/async` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #1: Function]/async` to the response with the `200` status
  - added the optional property `error/misalignment` to the response with the `429` status
- **2026-08-20** `5de4ab93fa24` — 2 warning
  - added the new `gpt-image-2` enum value to the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
  - added the new `gpt-image-2-2026-04-21` enum value to the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #9: Image generation tool]/model/anyOf[subschema #2]/` response property for the response status `200`
- **2026-08-14** `6ac2618eefd7` — 1 info
  - added the non-success response with the status `429`
- **2026-08-13** `fc45a2f64c0a` — 1 info
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #5: Web search]/external_web_access` to the response with the `200` status
- **2026-08-05** `ab0c5306e390` — 2 breaking, 4 warning, 18 info
  - the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #12: Namespace -> subschema #13: Namespace]/description` response property's minLength was decreased from `1` to `0` for the response status `200`
  - added `#/components/schemas/ProgrammaticToolCallingParam` to the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/` response property `oneOf` list for the response status `200`
  - added the new `auto` enum value to the `data_source/oneOf[subschema #2: CompletionsRunDataSource]/input_messages/oneOf[subschema #1: TemplateInputMessages]/template/items/oneOf[subschema #1: Input message]/content/oneOf[subschema #2: Input item content list]/items/oneOf[subschema #3: Input file]/detail` response property for the response status `200`
  - added the new `max` enum value to the `data_source/oneOf[subschema #2: CompletionsRunDataSource]/sampling_params/reasoning_effort/anyOf[subschema #1]/` response property for the response status `200`
  - added the new `max` enum value to the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/reasoning_effort/anyOf[subschema #1]/` response property for the response status `200`
  - added the new `max` enum value to the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/reasoning_effort/anyOf[#/components/schemas/ReasoningEffort]/anyOf[subschema #1]/` response property for the response status `200`
  - added the optional property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/input_messages/oneOf[subschema #1: TemplateInputMessages]/template/items/oneOf[subschema #1: Input message]/content/oneOf[subschema #2: Input item content list]/items/oneOf[subschema #1: Input text]/prompt_cache_breakpoint` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/input_messages/oneOf[subschema #1: TemplateInputMessages]/template/items/oneOf[subschema #1: Input message]/content/oneOf[subschema #2: Input item content list]/items/oneOf[subschema #2: Input image]/prompt_cache_breakpoint` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/input_messages/oneOf[subschema #1: TemplateInputMessages]/template/items/oneOf[subschema #1: Input message]/content/oneOf[subschema #2: Input item content list]/items/oneOf[subschema #3: Input file]/prompt_cache_breakpoint` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/input_messages/oneOf[subschema #1: TemplateInputMessages]/template/items/oneOf[subschema #2: Eval message object]/content/oneOf[subschema #1: Eval content item]/oneOf[subschema #2: Input text]/prompt_cache_breakpoint` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/input_messages/oneOf[subschema #1: TemplateInputMessages]/template/items/oneOf[subschema #2: Eval message object]/content/oneOf[subschema #2: An array of Input text, Output text, Input image, and Input audio]/items/oneOf[subschema #2: Input text]/prompt_cache_breakpoint` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/input_messages/oneOf[subschema #1: InputMessagesTemplate]/template/items/oneOf[subschema #2: Eval message object]/content/oneOf[subschema #1: Eval content item]/oneOf[subschema #2: Input text]/prompt_cache_breakpoint` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/input_messages/oneOf[subschema #1: InputMessagesTemplate]/template/items/oneOf[subschema #2: Eval message object]/content/oneOf[subschema #2: An array of Input text, Output text, Input image, and Input audio]/items/oneOf[subschema #2: Input text]/prompt_cache_breakpoint` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #10: Shell tool -> subschema #11: Shell tool]/allowed_callers` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #11: Custom tool -> subschema #12: Custom tool]/allowed_callers` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/oneOf[#/components/schemas/FunctionToolParam]/allowed_callers` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/oneOf[#/components/schemas/FunctionToolParam]/output_schema` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/oneOf[subschema #2: Custom tool]/allowed_callers` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #15: Apply patch tool -> subschema #16: Apply patch tool]/allowed_callers` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #1: Function]/allowed_callers` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #1: Function]/output_schema` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #6: MCP tool]/allowed_callers` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #6: MCP tool]/tunnel_id` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools/items/oneOf[subschema #7: Code interpreter]/allowed_callers` to the response with the `200` status
- **2026-05-13** `74cbcf73838f` — 17 breaking, 4 warning, 20 info
  - response property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/source/oneOf[subschema #3: StoredCompletionsRunDataSource]/created_after` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/source/oneOf[subschema #3: StoredCompletionsRunDataSource]/created_before` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/source/oneOf[subschema #3: StoredCompletionsRunDataSource]/limit` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/source/oneOf[subschema #3: StoredCompletionsRunDataSource]/metadata` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/source/oneOf[subschema #3: StoredCompletionsRunDataSource]/model` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/created_after` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/created_before` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/instructions_search` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/metadata` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/model` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/temperature` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/top_p` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/users` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `metadata` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added `#/components/schemas/EvalItemContentItem, #/components/schemas/EvalItemContentArray` to the `data_source/oneOf[subschema #2: CompletionsRunDataSource]/input_messages/oneOf[subschema #1: TemplateInputMessages]/template/items/oneOf[subschema #2: Eval message object]/content` response property `oneOf` list for the response status `200`
  - added `subschema #1: InputMessagesTemplate, subschema #2: InputMessagesItemReference` to the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/input_messages` response property `oneOf` list for the response status `200`
  - the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/reasoning_effort` response's property type changed from `string` to no type for status `200`
  - removed the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/allow_parallel_tool_calls` from the response with the `200` status
  - removed the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/has_tool_calls` from the response with the `200` status
  - added the new `original` enum value to the `data_source/oneOf[subschema #2: CompletionsRunDataSource]/input_messages/oneOf[subschema #1: TemplateInputMessages]/template/items/oneOf[subschema #1: Input message]/content/oneOf[subschema #2: Input item content list]/items/oneOf[subschema #2: Input image]/detail` response property for the response status `200`
  - added the new `responses` enum value to the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/type` response property for the response status `200`
  - added the optional property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/input_messages/oneOf[subschema #1: TemplateInputMessages]/template/items/oneOf[subschema #1: Input message]/content/oneOf[subschema #2: Input item content list]/items/oneOf[subschema #3: Input file]/detail` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/input_messages/oneOf[subschema #1: TemplateInputMessages]/template/items/oneOf[subschema #1: Input message]/content/oneOf[subschema #2: Input item content list]/items/oneOf[subschema #3: Input file]/file_url` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/input_messages/oneOf[subschema #1: TemplateInputMessages]/template/items/oneOf[subschema #1: Input message]/phase` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/sampling_params/reasoning_effort` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/sampling_params/response_format` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #2: CompletionsRunDataSource]/sampling_params/tools` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/reasoning_effort` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/text` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/sampling_params/tools` to the response with the `200` status
  - added the optional property `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/tools` to the response with the `200` status
  - added `#/components/schemas/ReasoningEffort, subschema #2` to the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/reasoning_effort` response property `anyOf` list for the response status `200`
  - the `type` response's property default value changed from `completions` to `responses` for the status `200`
  - the `reasoning_effort` response's property default value `medium` was removed for the status `200`
  - added discriminator to `data_source/oneOf[subschema #2: CompletionsRunDataSource]/input_messages/oneOf[subschema #1: TemplateInputMessages]/template/items/oneOf[subschema #1: Input message]/content/oneOf[subschema #2: Input item content list]/items/` response property for the response status `200`
  - removed the `completions` enum value from the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/type` response property for the response status `200`
  - removed the `high` enum value from the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/reasoning_effort` response property for the response status `200`
  - removed the `low` enum value from the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/reasoning_effort` response property for the response status `200`
  - removed the `medium` enum value from the `data_source/oneOf[subschema #3: ResponsesRunDataSource]/source/oneOf[subschema #3: EvalResponsesSource]/reasoning_effort` response property for the response status `200`
  - removed `#/components/schemas/InputTextContent, subschema #1: Text input, subschema #3: Output text` from the `data_source/oneOf[subschema #2: CompletionsRunDataSource]/input_messages/oneOf[subschema #1: TemplateInputMessages]/template/items/oneOf[subschema #2: Eval message object]/content` response property `oneOf` list for the response status `200`
  - …1 more
- **2025-04-29** `6a6c681b1820` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/openai/apis/openapi/docs/evals/:eval_id/runs/:run_id/get.md) · [API](https://skmtc.dev/openai/apis/openapi.md) · [Page](https://skmtc.dev/openai/apis/openapi/changes/evals/:eval_id/runs/:run_id/get)
