Skip to contentSkip to page list

Docs

Restore a dataset version

Restore a version: the dataset's columns and rows become the version's, and the result is saved as a new version. Earlier versions are never changed.

POST/api/v1/dataset/{slugOrId}/versions/{version}/restore
Request and response examples
request.py
import osimport requests​origin = "https://app.langwatch.ai"path = "/api/v1/dataset/<slugOrId>/versions/<version>/restore"api_key = os.environ["LANGWATCH_API_KEY"]headers = {    "X-Auth-Token": api_key,}​response = requests.post(    origin + path,    headers=headers,)print(response.json())

Success

application/json · Generated from schema

{  "version": {    "id": "string",    "projectId": "string",    "datasetId": "string",    "version": 0,    "name": "string",    "trigger": "autosave",    "contentHash": "string",    "columnTypes": [      {        "name": "string",        "type": "string"      }    ],    "rowCount": 0,    "sizeBytes": 0,    "chunkCount": 0,    "restoredFromVersion": 0,    "authorId": "string",    "authorKind": "user",    "pinned": false,    "runCount": 0,    "createdAt": "2026-01-01T00:00:00Z"  },  "changed": false}
api-reference/datasets/restore-a-dataset-version

Authorization

X-Auth-Tokenstringheaderrequired

Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.

Path parameters

slugOrIdstringrequired
versionintegerrequired
Maximum 9007199254740991

Responses

200

Success

application/json

versionobjectrequired
idstringrequired
At least 1 character
projectIdstringrequired
At least 1 character
datasetIdstringrequired
At least 1 character
versionintegerrequired
Maximum 9007199254740991
namestring | nullrequired
triggerstringrequired
One of"autosave""manual""experiment_run""restore""initial"
contentHashstringrequired
At least 1 character
columnTypesobject[]required
rowCountintegerrequired
Minimum 0Maximum 9007199254740991
sizeBytesintegerrequired
Minimum 0Maximum 9007199254740991
chunkCountintegerrequired
Minimum 0Maximum 9007199254740991
restoredFromVersioninteger | nullrequired
authorIdstring | nullrequired
authorKindstring | nullrequired
pinnedbooleanrequired
runCountintegerrequired
Minimum 0Maximum 9007199254740991
createdAtstring (date-time)required
changedbooleanrequired
404

The dataset has no version with that number.

Documentation