Sign in
chats

Initialize Chat

Initializes a new chat from source content such as files, repositories, registries, or zip archives. Enables context-rich conversations based on code or assets.

post/chats/init

Request body

OR
OR
OR
OR

Response

Success

idstring required

A unique identifier for the chat.

object'chat' required

Fixed value identifying this object as a chat.

shareableboolean required

Indicates whether the chat can be shared via public link.

privacy'public' | 'private' | 'team' | 'team-edit' | 'unlisted' required

Defines the visibility of the chat—private, team-only, or public.

namestring

An optional name assigned to the chat by the user.

titlestring

Deprecated title field preserved for backward compatibility.

createdAtstring date-time required

The ISO timestamp representing when the chat was created.

updatedAtstring

The ISO timestamp of the last update to the chat.

favoriteboolean required

Indicates whether the chat is marked as a favorite.

authorIdstring required

The ID of the user who created the chat.

projectIdstring

Optional ID of the v0 project associated with this chat.

webUrlstring required

Web URL to view this chat in the browser.

apiUrlstring required

API URL to access this chat via the API.

urlstring required

The canonical URL to access this chat.

demostring

Deprecated demo URL used for previewing the chat result.

textstring required

The main user prompt or instruction that started the chat.

Changes