---
title: "update an eval dataset"
method: POST
path: "/w/{workspace}/ai_evals/datasets/update/{path}"
tags: ["ai_evals"]
---

# update an eval dataset

`POST /w/{workspace}/ai_evals/datasets/update/{path}`

## Path parameters

- `workspace` string, required
- `path` string, required

## Request body

- object
  - `path` string — Renames the dataset. Its cases and experiments follow through the foreign keys, so a rename keeps the history it already has.
  - `summary` string — Left out to keep the stored summary; sent as "" to clear it.
  - `scorers` Scorer[] — Left out to keep the dataset's columns as they are; sent to replace them wholesale.
    - `id` string
    - `name` string — Column header. Defaults to the last segment of the path.
    - `pass_if` number — A score at or above this counts as a pass, and the column reports a pass rate beside its mean. Applied when results are read rather than when they are produced, so moving the line re-reads every score already recorded instead of invalidating them.
    - `kind` 'script' | 'agent', required
    - `path` string, required — The script, or the ai_agent resource used as a judge.
  - `cases` SaveEvalCase[] — The cases as they should stand afterwards: all of them, each carrying its id if the dataset already has it. Sent with the rest of an edit so that a rename the dataset refuses refuses the case edits with it.
    - `id` string, uuid — Absent for a case the dataset does not hold yet.
    - `input` EvalCaseInput — The inputs a standalone run feeds the agent.
      - `user_message` string
      - `user_attachments` object[]
    - `expected` unknown

## Response `200`

eval dataset updated

---

[API](https://skmtc.dev/windmill/apis/windmill-api.md) · [All operations](https://skmtc.dev/windmill/apis/windmill-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/windmill/windmill-api/revisions/7b281701c340/schema)