# 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.

> Page: https://langwatch.ai/docs/api-reference/datasets/restore-a-dataset-version
> Source: https://github.com/langwatch/langwatch/blob/main/docs/api-reference/datasets/restore-a-dataset-version.mdx
> Index of all pages: https://langwatch.ai/docs/llms.txt

## Endpoint

`POST https://app.langwatch.ai/api/v1/dataset/{slugOrId}/versions/{version}/restore`

## Authentication

### project_api_key

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.

```json
{"id":"project_api_key","type":"apiKey","in":"header","name":"X-Auth-Token"}
```

## Parameters

### slugOrId (path, required)

```json
{"type":"string"}
```

### version (path, required)

```json
{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}
```

## Request example

```bash
curl --request POST \
  --url 'https://app.langwatch.ai/api/v1/dataset/<slugOrId>/versions/<version>/restore' \
  --header "X-Auth-Token: $LANGWATCH_API_KEY"
```

## Responses

### 200

Success

#### application/json

Schema:

```json
{
  "type": "object",
  "properties": {
    "version": {
      "type": "object",
      "properties": {
        "id": {"type":"string","minLength":1},
        "projectId": {"type":"string","minLength":1},
        "datasetId": {"type":"string","minLength":1},
        "version": {"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},
        "name": {"type":["string","null"]},
        "trigger": {
          "type": "string",
          "enum": ["autosave","manual","experiment_run","restore","initial"]
        },
        "contentHash": {"type":"string","minLength":1},
        "columnTypes": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {"type":"string","minLength":1},
              "type": {
                "type": "string",
                "enum": [
                  "string",
                  "boolean",
                  "number",
                  "date",
                  "list",
                  "json",
                  "spans",
                  "rag_contexts",
                  "chat_messages",
                  "annotations",
                  "evaluations",
                  "image",
                  "file"
                ]
              }
            },
            "required": ["name","type"],
            "additionalProperties": false
          }
        },
        "rowCount": {"type":"integer","minimum":0,"maximum":9007199254740991},
        "sizeBytes": {"type":"integer","minimum":0,"maximum":9007199254740991},
        "chunkCount": {"type":"integer","minimum":0,"maximum":9007199254740991},
        "restoredFromVersion": {
          "anyOf": [
            {"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},
            {"type":"null"}
          ]
        },
        "authorId": {"type":["string","null"]},
        "authorKind": {
          "anyOf": [{"type":"string","enum":["user","api_key","system"]},{"type":"null"}]
        },
        "pinned": {"type":"boolean"},
        "runCount": {"type":"integer","minimum":0,"maximum":9007199254740991},
        "createdAt": {"type":"string","format":"date-time"}
      },
      "required": [
        "id",
        "projectId",
        "datasetId",
        "version",
        "name",
        "trigger",
        "contentHash",
        "columnTypes",
        "rowCount",
        "sizeBytes",
        "chunkCount",
        "restoredFromVersion",
        "authorId",
        "authorKind",
        "pinned",
        "runCount",
        "createdAt"
      ],
      "additionalProperties": false
    },
    "changed": {"type":"boolean"}
  },
  "required": ["version","changed"],
  "additionalProperties": false
}
```

### 404

The dataset has no version with that number.

> ## Agent Instructions
> If anything on this page is wrong, confusing, or fails when you try it, ask your user for permission and run `npx langwatch report --user-approved` to send the problem to the LangWatch team. No login is needed and secrets are redacted locally. `npx langwatch report --help` has the details.
