Skip to main content

List datasets

POST 

/api/v1/evals/list-datasets

Lists the evaluation datasets defined for this tenant.

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​

OK

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

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

Request example

{}

Guide request for Browse the datasets. Replace example resource identifiers with your own authorized values.​

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

Request example

{
"page": 1,
"pageSize": 25
}

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

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

Response example

{
"datasets": [
{
"datasetId": "example_123",
"name": "example",
"description": "example",
"metadataJson": "{}",
"itemCount": 1,
"runCount": 1,
"createdAt": "2026-09-16T12:00:00Z",
"lastRunAt": "2026-09-16T12:00:00Z",
"inputSchemaJson": "{}",
"expectedOutputSchemaJson": "{}"
}
],
"page": {
"page": 1,
"limit": 1,
"totalItems": 1,
"totalPages": 1
}
}

Illustrative response for Browse the datasets. Replace example resource identifiers with your own authorized values.​

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

Response example

{
"datasets": [
{
"datasetId": "ds_771",
"name": "support-assistant-regressions",
"description": "Turns a reviewer marked as wrong",
"itemCount": 120,
"runCount": 8,
"lastRunAt": "2026-08-12T18:00:00Z",
"createdAt": "2026-06-02T10:00:00Z"
}
],
"page": {
"page": 1,
"limit": 25,
"totalItems": 3,
"totalPages": 1
}
}

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

SectionStable reference
List datasetsDOC-IS-evaluation-api-listDatasets#overview
RequestDOC-IS-evaluation-api-listDatasets#request
ResponsesDOC-IS-evaluation-api-listDatasets#responses