Restore dataset to a previous version

import requests
url = "http://localhost:5173/api/v1/private/datasets/id/versions/restore"
payload = { "version_ref": "a1b2c3d4e5f67890123456789abcdef0" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "dataset_id": "7e57d004-2b97-0e7a-b45f-5387367791cd",
  "version_hash": "a1b2c3d4e5f67890123456789abcdef0",
  "tags": [
    "release-candidate",
    "stable"
  ],
  "is_latest": true,
  "version_name": "v5",
  "items_total": 1500,
  "items_added": 200,
  "items_modified": 50,
  "items_deleted": 10,
  "change_description": "Restored dataset to version v4 after rollback due to data corruption.",
  "metadata": {},
  "evaluators": [
    {
      "name": "QualityCheckLLM",
      "type": "llm_judge",
      "config": {}
    }
  ],
  "execution_policy": {
    "runs_per_item": 3,
    "pass_threshold": 85
  },
  "created_at": "2024-01-15T09:30:00Z",
  "created_by": "data.engineer@company.com",
  "last_updated_at": "2024-01-15T09:30:00Z",
  "last_updated_by": "data.engineer@company.com"
}

Restores the dataset to a previous version state by creating a new version with items copied from the specified version. If the version is already the latest, returns it as-is (no-op).

Path parameters

idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

version_refstringRequired>=1 character

Version hash or tag to restore from

Response

Version restored successfully

idstring or nullRead-onlyformat: "uuid"

dataset_idstring or nullRead-onlyformat: "uuid"

version_hashstring or nullRead-only

tagslist of strings or nullRead-only

is_latestboolean or nullRead-only

Indicates whether this is the latest version of the dataset

version_namestring or nullRead-only

Sequential version name formatted as 'v1', 'v2', etc.

items_totalinteger or nullRead-only

Total number of items in this version

items_addedinteger or nullRead-only

Number of items added since last version

items_modifiedinteger or nullRead-only

Number of items modified since last version

items_deletedinteger or nullRead-only

Number of items deleted since last version

change_descriptionstring or nullRead-only

metadatamap from strings to strings or nullRead-only

evaluatorslist of objects or nullRead-only

Default evaluators for items in this version

execution_policyobject or nullRead-only

Default execution policy for items in this version

created_atdatetime or nullRead-only

created_bystring or nullRead-only

last_updated_atdatetime or nullRead-only

last_updated_bystring or nullRead-only

Path parameters

Request

Response

Errors