Skip to main content

Update a dataset item

POST 

/api/v1/evals/update-dataset-item

Edits an item — typically to fill in expectedOutputJson after review.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Replay datasets and runs · Dataset identity and run provenance

Request​

Responses​

OK

Replace an existing item using its dataset name; retain the input when revising its expected output.​

Section ID: DOC-IS-evaluation-api-updateDatasetItem#example-evals-updateDatasetItem-request

Request example

{
"itemId": "item_123",
"datasetId": "support-answers",
"inputJson": "{\"question\":\"How do I reset my password?\"}",
"expectedOutputJson": "\"Use the password reset link on the sign-in page.\""
}

Guide request for 3. Define what an acceptable answer must do. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-IS-evaluation-api-updateDatasetItem#example-cookbook-insights-evaluation-datasets-and-runs-04-request

Request example

{
"itemId": "…",
"datasetId": "support-assistant-regressions",
"expectedOutputJson": "{\"answer\": \"…\"}"
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-IS-evaluation-api-updateDatasetItem#example-evals-updateDatasetItem-response

Response example

{
"itemId": "example_123"
}

Document ID: DOC-IS-evaluation-api-updateDatasetItem. Section identities and revisions.

SectionStable reference
Update a dataset itemDOC-IS-evaluation-api-updateDatasetItem#overview
RequestDOC-IS-evaluation-api-updateDatasetItem#request
ResponsesDOC-IS-evaluation-api-updateDatasetItem#responses