List dataset runs

POST 
/api/v1/evals/list-dataset-runs

Lists past runs against a dataset.

Uses cursorPage. Dataset-name resolution currently searches only the first dataset page. Item-count enrichment is bounded and can leave zero after failure; a zero count does not prove that no items ran.

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-listDatasetRuns#example-evals-listDatasetRuns-request

Request example

{
  "datasetName": "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-listDatasetRuns#example-cookbook-insights-evaluation-datasets-and-runs-06-request

Request example

{
  "datasetName": "support-assistant-regressions",
  "pageSize": 25
}

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

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

Response example

{
  "runs": [
    {
      "runId": "example_123",
      "datasetId": "example_123",
      "name": "example",
      "description": "example",
      "metadataJson": "{}",
      "itemCount": 1,
      "createdAt": "2026-09-16T12:00:00Z"
    }
  ],
  "cursorPage": {
    "nextCursor": "example",
    "limit": 1,
    "totalItems": 1
  }
}

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-listDatasetRuns#example-cookbook-insights-evaluation-datasets-and-runs-json-01-response

Response example

{
  "runs": [
    {
      "runId": "run_0912",
      "name": "2026-08-12-candidate",
      "datasetId": "ds_771",
      "description": "profile revision and qualified model recorded in manifest",
      "itemCount": 120,
      "createdAt": "2026-08-12T18:00:00Z"
    }
  ],
  "cursorPage": {
    "limit": 25
  }
}

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

Section	Stable reference
List dataset runs	DOC-IS-evaluation-api-listDatasetRuns#overview
Request	DOC-IS-evaluation-api-listDatasetRuns#request
Responses	DOC-IS-evaluation-api-listDatasetRuns#responses