v0 Platform API/API Reference/Chats

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)

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.

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