Skip to contentSkip to page list

Docs

Save a dataset version

Save the dataset's current content as a version, with an optional name. When the content equals the latest version, no version is created and the latest one is answered (named, when a name is given).

POST/api/v1/dataset/{slugOrId}/versions
Request and response examples
request.py
import osimport requests​origin = "https://app.langwatch.ai"path = "/api/v1/dataset/<slugOrId>/versions"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

{  "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"}
api-reference/datasets/save-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

Request body

application/json

namestring
At least 1 characterUp to 120 characters

Responses

200

Success

application/json

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
namestringrequired
At least 1 character
typestringrequired
One of"string""boolean""number""date""list""json""spans""rag_contexts""chat_messages""annotations""evaluations""image""file"
rowCountintegerrequired
Minimum 0Maximum 9007199254740991
sizeBytesintegerrequired
Minimum 0Maximum 9007199254740991
chunkCountintegerrequired
Minimum 0Maximum 9007199254740991
restoredFromVersioninteger | nullrequired
Option 1integer
Option 2null
authorIdstring | nullrequired
authorKindstring | nullrequired
Option 1string
Option 2null
pinnedbooleanrequired
runCountintegerrequired
Minimum 0Maximum 9007199254740991
createdAtstring (date-time)required

Documentation