---
title: "Changes to Update an eval"
method: POST
path: "/evals/{eval_id}"
---

# Changes to Update an eval

`POST /evals/{eval_id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 163 revisions.

- **2026-09-25** `d86203de41ae` — 2 info
- **2026-09-03** `9430b00d75b4` — 1 info
- **2026-08-14** `6ac2618eefd7` — 1 info
- **2026-08-05** `ab0c5306e390` — 1 warning, 5 info
- **2026-05-13** `74cbcf73838f` — 5 breaking, 3 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-03** `9430b00d75b4` — 1 info
  - added the optional property `error/misalignment` to the response with the `429` status
- **2026-08-14** `6ac2618eefd7` — 1 info
  - added the non-success response with the status `429`
- **2026-08-05** `ab0c5306e390` — 1 warning, 5 info
  - added the new `max` enum value to the `testing_criteria/items/oneOf[subschema #5: ScoreModelGrader]/allOf[subschema #1: ScoreModelGrader]/sampling_params/reasoning_effort/anyOf[subschema #1]/` response property for the response status `200`
  - added the optional property `testing_criteria/items/oneOf[subschema #1: LabelModelGrader]/allOf[subschema #1: LabelModelGrader]/input/items/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 `testing_criteria/items/oneOf[subschema #1: LabelModelGrader]/allOf[subschema #1: LabelModelGrader]/input/items/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 `testing_criteria/items/oneOf[subschema #5: ScoreModelGrader]/allOf[subschema #1: ScoreModelGrader]/input/items/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 `testing_criteria/items/oneOf[subschema #5: ScoreModelGrader]/allOf[subschema #1: ScoreModelGrader]/input/items/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
  - the `testing_criteria` response's property default value `eval` was removed for the status `200`
- **2026-05-13** `74cbcf73838f` — 5 breaking, 3 info
  - the request property `metadata` became not nullable
  - response property `data_source_config/oneOf[subschema #2: StoredCompletionsDataSourceConfig -> subschema #3: StoredCompletionsDataSourceConfig]/metadata` 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/EvalGraderLabelModel, #/components/schemas/EvalGraderStringCheck, #/components/schemas/EvalGraderTextSimilarity, #/components/schemas/EvalGraderPython, #/components/schemas/EvalGraderScoreModel` to the `testing_criteria/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/EvalLogsDataSourceConfig` to the `data_source_config` response property `oneOf` list for the response status `200`
  - request property `metadata` list-of-types was widened by adding types `null` to media type `application/json`
  - response property `data_source_config/oneOf[subschema #2: StoredCompletionsDataSourceConfig -> subschema #3: StoredCompletionsDataSourceConfig]/` deprecated
  - removed `#/components/schemas/EvalLabelModelGrader, #/components/schemas/EvalStringCheckGrader, #/components/schemas/EvalTextSimilarityGrader, #/components/schemas/EvalPythonGrader, #/components/schemas/EvalScoreModelGrader` from the `testing_criteria/items/` response property `oneOf` list for the response status `200`
- **2025-04-29** `6a6c681b1820` — 1 info
  - endpoint added

---

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