Find Chat Versions

Retrieves a list of all versions (iterations) for a specific chat, ordered by creation date (newest first). Supports cursor-based pagination and includes version status and demo URLs.

GET/v1/chats/{chatId}/versions

Usage

TypeScript Example

import { v0 } from 'v0-sdk'

const result = await v0.chats.findVersions()

console.log(result)

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

API Signature

Request

Path Parameters

chatId: string

The unique identifier of the chat to retrieve versions for. Provided as a path parameter.

Query Parameters

limit?: number

Specifies the maximum number of version records to return in a single response. Useful for paginating results when there are many versions.

cursor?: string

Base64 encoded cursor containing pagination data

Response

object: 'list'

data: object[]

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 [Image blocked: No description] 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.

pagination: object

hasMore: boolean

nextCursor?: string

nextUrl?: string