Get a dataset run

POST 
/api/v1/evals/get-dataset-run

Fetches run metadata by dataset name and run name. It does not return per-item results.

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

Request

Responses

200

OK

Schema-valid request illustration; replace example identifiers and confirm operation prerequisites.

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

Request example

{
  "datasetName": "example",
  "runName": "example"
}

Guide request for 5. Decide whether the change fixes the problem without regressions. Replace example resource identifiers with your own authorized values.

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

Request example

{
  "datasetName": "support-assistant-regressions",
  "runName": "2026-08-12-candidate"
}

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

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

Response example

{
  "run": {
    "runId": "example_123",
    "datasetId": "example_123",
    "name": "example",
    "description": "example",
    "metadataJson": "{}",
    "itemCount": 1,
    "createdAt": "2026-09-16T12:00:00Z"
  }
}

Illustrative response for 5. Decide whether the change fixes the problem without regressions. Replace example resource identifiers with your own authorized values.

Section ID: DOC-IS-evaluation-api-getDatasetRun#example-cookbook-insights-evaluation-datasets-and-runs-json-02-response

Response example

{
  "run": {
    "runId": "run_0912",
    "name": "2026-08-12-candidate",
    "datasetId": "ds_771",
    "itemCount": 120,
    "metadataJson": "{\"profileRevisionHash\":\"9f2c1e…\"}",
    "createdAt": "2026-08-12T18:00:00Z"
  }
}

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

Section	Stable reference
Get a dataset run	DOC-IS-evaluation-api-getDatasetRun#overview
Request	DOC-IS-evaluation-api-getDatasetRun#request
Responses	DOC-IS-evaluation-api-getDatasetRun#responses