---
title: Restore Chat Version
description: Restores a chat to a specific version in-place. Unlike forking, this keeps the same chat ID and creates a new version entry pointing to the restored files.
product: Platform API
type: reference
prerequisites:
  - /docs/api/platform/quickstart
---

# Restore Chat Version



<EndpointDisplay method="post" path="/chats/{chatId}/versions/{versionId}/restore" />

## Usage [#usage]

<CustomCodeBlock languages="['TypeScript', 'cURL']" defaultLanguage="TypeScript">
  <CodeVariant
    language="TypeScript"
    title="TypeScript Example"
    code="`import { v0 } from 'v0-sdk'

const result = await v0.chats.restoreVersion({
  chatId: '123',
  versionId: 'abc',
})

console.log(result)`"
  />

  <CodeVariant
    language="cURL"
    title="cURL Example"
    code="`curl -X POST https://api.v0.dev/v1/chats/123/versions/abc/restore \
  -H &#x22;Authorization: Bearer $V0_API_KEY&#x22;`"
  />
</CustomCodeBlock>

## API Signature [#api-signature]

### Request [#request]

#### Path Parameters [#path-parameters]

<APISignature
  parameters="[
  {
    &#x22;name&#x22;: &#x22;chatId&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;The unique identifier of the chat containing the version to restore. Provided as a path parameter.&#x22;
  },
  {
    &#x22;name&#x22;: &#x22;versionId&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;The unique identifier of the version to restore. Provided as a path parameter.&#x22;
  }
]"
/>

### Response [#response]

<APISignature
  parameters="[
  {
    &#x22;name&#x22;: &#x22;id&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;A unique identifier for the version.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;object&#x22;,
    &#x22;type&#x22;: &#x22;'version'&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;Fixed value identifying this object as a version.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;status&#x22;,
    &#x22;type&#x22;: &#x22;'pending' | 'completed' | 'failed'&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;The current status of the version generation process.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;demoUrl&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: false,
    &#x22;description&#x22;: &#x22;Optional URL for previewing the generated output.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;screenshotUrl&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: false,
    &#x22;description&#x22;: &#x22;URL to retrieve a screenshot of this version.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;createdAt&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;The date and time when the version was created, in ISO 8601 format.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;updatedAt&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: false,
    &#x22;description&#x22;: &#x22;The date and time when the version was last updated, in ISO 8601 format.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;files&#x22;,
    &#x22;type&#x22;: &#x22;object[]&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;A list of files that were generated or included in this version.&#x22;,
    &#x22;deprecated&#x22;: false,
    &#x22;arrayItems&#x22;: {
      &#x22;name&#x22;: &#x22;item&#x22;,
      &#x22;type&#x22;: &#x22;object&#x22;,
      &#x22;required&#x22;: true,
      &#x22;description&#x22;: &#x22;Detailed representation of a file, including its content and lock status.&#x22;,
      &#x22;deprecated&#x22;: false,
      &#x22;properties&#x22;: [
        {
          &#x22;name&#x22;: &#x22;object&#x22;,
          &#x22;type&#x22;: &#x22;'file'&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;Fixed value identifying this object as a file.&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;name&#x22;,
          &#x22;type&#x22;: &#x22;string&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;The name of the file, including its extension.&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;content&#x22;,
          &#x22;type&#x22;: &#x22;string&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;The full contents of the file as a raw string.&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;locked&#x22;,
          &#x22;type&#x22;: &#x22;boolean&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;Whether the file is locked to prevent AI from overwriting it during new version generation.&#x22;,
          &#x22;deprecated&#x22;: false
        }
      ]
    }
  }
]"
/>