Get Chat Version

Retrieves detailed information about a specific version of a chat, including all files with their content and lock status.

GET/v1/chats/{chatId}/versions/{versionId}

Usage

TypeScript Example

import { v0 } from 'v0-sdk'const result = await v0.chats.getVersion()console.log(result)

API Signature

Request

Path Parameters

chatId: string

The unique identifier of the chat containing the version. Provided as a path parameter.

versionId: string

The unique identifier of the version to retrieve. Provided as a path parameter.

Query Parameters

includeDefaultFiles?: 'true' | 'false'

When true, includes all default files (package.json, configuration files, etc.) that would be part of a ZIP download. When false or omitted, returns only the generated source files.

Response

id: string

A unique identifier for the version.

object: 'version'

Fixed value identifying this object as a version.

status: 'pending' | 'completed' | 'failed'

The current status of the version generation process.

demoUrl?: string

Optional URL for previewing the generated output.

screenshotUrl?: string

An authenticated URL to retrieve a screenshot of this version. Fetching this URL requires the same Authorization: Bearer header as all other API calls — it cannot be used directly as an <img> src. To display it in a browser, proxy the request server-side and forward the Authorization header. Append ?ignoreCache=1 to bypass the one-week screenshot cache.

createdAt: string

The date and time when the version was created, in ISO 8601 format.

updatedAt?: string

The date and time when the version was last updated, in ISO 8601 format.

files: object[]

A list of files that were generated or included in this version.

object: 'file'

Fixed value identifying this object as a file.

name: string

The name of the file, including its extension.

content: string

The full contents of the file as a raw string.

locked: boolean

Whether the file is locked to prevent AI from overwriting it during new version generation.