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.
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).
Try this endpoint
app.langwatch.ai
API key · X-Auth-Token
Kept in this tab. Cleared when you reload.
Body (application/json)
This sends a live request to app.langwatch.ai.
Request and response examples
request.py
import osimport requestsorigin = "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())const url = "https://app.langwatch.ai/api/v1/dataset/<slugOrId>/versions";const response = await fetch(url, { method: "POST", headers: { "X-Auth-Token": process.env.LANGWATCH_API_KEY!, },});const data = await response.json();curl --request POST \ --url 'https://app.langwatch.ai/api/v1/dataset/<slugOrId>/versions' \ --header "X-Auth-Token: $LANGWATCH_API_KEY"Call the LangWatch API from this project: Save a dataset version.Request: POST https://app.langwatch.ai/api/v1/dataset/<slugOrId>/versionsReference: https://langwatch.ai/docs/api-reference/datasets/save-a-dataset-version.mdAuthentication: send the X-Auth-Token header, read from the LANGWATCH_API_KEY environment variable. Never hard-code the key.Use the HTTP client this project already uses, handle non-2xx responses, and show me the parsed result.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"}Path parameters
slugOrIdstringrequiredRequest body
application/json
namestringAt least 1 characterUp to 120 characters
Responses
200Success
application/json
idstringrequiredAt least 1 character
projectIdstringrequiredAt least 1 character
datasetIdstringrequiredAt least 1 character
versionintegerrequiredMaximum 9007199254740991
namestring | nullrequiredtriggerstringrequiredOne of
"autosave""manual""experiment_run""restore""initial"contentHashstringrequiredAt least 1 character
columnTypesobject[]requiredrowCountintegerrequiredMinimum 0Maximum 9007199254740991
sizeBytesintegerrequiredMinimum 0Maximum 9007199254740991
chunkCountintegerrequiredMinimum 0Maximum 9007199254740991
restoredFromVersioninteger | nullrequiredauthorIdstring | nullrequiredauthorKindstring | nullrequiredpinnedbooleanrequiredrunCountintegerrequiredMinimum 0Maximum 9007199254740991
createdAtstring (date-time)required