For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Copy to LLMGithubGo to App
DocumentationIntegrationsBuilding Self-Improving AgentsSelf-hosting OpikSDK & API reference
DocumentationIntegrationsBuilding Self-Improving AgentsSelf-hosting OpikSDK & API reference
    • Overview
  • Python SDK
    • Reference
    • REST API Client
  • Typescript SDK
    • Overview
    • Opik TS
    • Prompts
    • Opik Query Language (OQL)
  • Rest API
    • Overview
        • POSTApply changes to dataset items
        • PATCHBatch update dataset items
        • GETFind datasets
        • POSTCreate dataset
        • PUTCreate/update dataset items
        • POSTCreate dataset items from CSV file
        • POSTCreate dataset items from spans
        • POSTCreate dataset items from traces
        • GETGet dataset by id
        • PUTUpdate dataset by id
        • DELDelete dataset by id
        • POSTDelete dataset by name
        • POSTDelete dataset items
        • POSTDelete datasets
        • GETDownload dataset export file
        • POSTExpand dataset with synthetic samples
        • GETFind dataset items with experiment items
        • POSTGet dataset by name
        • GETGet experiment items stats for dataset
        • GETGet dataset export job status
        • GETGet all dataset export jobs
        • GETGet dataset item by id
        • PATCHPartially update dataset item by id
        • GETGet dataset items
        • GETGet dataset items output columns
        • PUTMark dataset export job as viewed
        • POSTStart dataset CSV export
        • POSTStream dataset items
        • GETCompare latest version with draft
        • POSTCreate version tag
        • DELDelete version tag
        • GETList dataset versions
        • POSTRestore dataset to a previous version
        • POSTRetrieve dataset version by name
        • PATCHUpdate dataset version
LogoLogo
Copy to LLMGithubGo to App
Rest APIAPI ReferenceDatasets

List dataset versions

GET
/v1/private/datasets/:id/versions
GET
/api/v1/private/datasets/:id/versions
$curl http://localhost:5173/api/v1/private/datasets/id/versions
1{
2 "content": [
3 {
4 "id": "string",
5 "dataset_id": "string",
6 "version_hash": "string",
7 "tags": [
8 "string"
9 ],
10 "is_latest": true,
11 "version_name": "string",
12 "items_total": 1,
13 "items_added": 1,
14 "items_modified": 1,
15 "items_deleted": 1,
16 "change_description": "string",
17 "metadata": {},
18 "evaluators": [
19 {
20 "name": "string",
21 "type": "llm_judge",
22 "config": {}
23 }
24 ],
25 "execution_policy": {
26 "runs_per_item": 1,
27 "pass_threshold": 1
28 },
29 "created_at": "2024-01-15T09:30:00Z",
30 "created_by": "string",
31 "last_updated_at": "2024-01-15T09:30:00Z",
32 "last_updated_by": "string"
33 }
34 ],
35 "page": 1,
36 "size": 1,
37 "total": 1
38}

Get paginated list of versions for a dataset, ordered by creation time (newest first)

Was this page helpful?
Previous

Restore dataset to a previous version

Next
Built with

Path parameters

idstringRequiredformat: "uuid"

Query parameters

pageintegerOptional>=1Defaults to 1
sizeintegerOptional>=1Defaults to 10

Response

Dataset versions
contentlist of objects
pageinteger
sizeinteger
totallong

Errors

400
Bad Request Error