/v0-chats | Type: Application | PCID required: Yes
Tools
| Tool | Description |
|---|---|
v0_chats_create | Create Chat |
v0_chats_delete | Delete Chat |
v0_chats_delete_version_files | Delete Chat Version Files |
v0_chats_download_version | Download version files |
v0_chats_favorite | Favorite Chat |
v0_chats_find | Find Chats |
v0_chats_find_messages | Find Chat Messages |
v0_chats_find_versions | Find Chat Versions |
v0_chats_fork | Fork Chat |
v0_chats_get_by_id | Get Chat |
v0_chats_get_message | Get Chat Message |
v0_chats_get_version | Get Chat Version |
v0_chats_init | Initialize Chat |
v0_chats_resolve_task | Resolve Task |
v0_chats_resume | Resume Message |
v0_chats_send_message | Send Message |
v0_chats_stop | Stop Message |
v0_chats_update | Update Chat |
v0_chats_update_version | Update Chat Version Files |
v0_chats_create
Create Chat Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
attachedSkillIds | string[] | No | — | Array of skill IDs (from skills.sh) to attach to this chat. Skills provide domain-specific knowledge and instructions that guide the AI. Maximum 3 skills per chat. |
attachments | object[] | No | — | A list of files or assets to be included in the conversation context. Useful when the chat or task requires referencing documents, images, or other resources. |
chatPrivacy | string | No | — | Determines the privacy setting of the chat. This can control whether the chat is visible only to the user, to team members, or is public. |
designSystemId | string | No | — | The ID of a design system to apply to this chat. Design systems provide consistent styling and components for generated UI. |
mcpServerIds | string[] | No | — | Array of MCP server IDs to enable for this chat. When provided, only the specified servers will be used. When omitted, falls back to the user’s enabled MCP servers. |
message | string | Yes | — | Creates a new chat using a user message, optional system context, and model configuration. Useful for prompting the model within the scope of a specific project. |
metadata | object | No | — | Arbitrary key-value data to attach to the chat. Useful for storing additional data about the chat, such as external user IDs. |
modelConfiguration | object | No | — | Settings that control how the model behaves in the chat. |
projectId | string | No | — | Associates the chat with a specific project in your workspace. Helps organize and group related chats under a common project context. |
responseMode | string | No | — | Controls how the response is delivered. - "sync": The response is returned immediately with the HTTP request. - "async": Returns a message placeholder immediately; use getById to poll for completion status and final output. - "experimental_stream": Returns content parts as Server-Sent Events for real-time streaming. |
system | string | No | — | Provides system-level context or background for the chat. This is typically used to specify frameworks, tools, or development environments relevant to the task. |
v0_chats_delete
Delete Chat Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat to delete. This must be passed as a path parameter in the URL. |
v0_chats_delete_version_files
Delete Chat Version Files Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat containing the version to delete files from. |
versionId | string | Yes | — | The unique identifier of the version (block) to delete files from. |
filePaths | string[] | Yes | — | Array of file paths to delete (e.g., [“components/test.tsx”, “lib/utils.ts”]) |
v0_chats_download_version
Download version files Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat containing the version. Provided as a path parameter. |
versionId | string | Yes | — | The unique identifier of the version to download. Provided as a path parameter. |
format | string | No | — | The archive format for the download. Choose “zip” for broad compatibility or “tarball” for Unix/Linux systems. |
includeDefaultFiles | string | No | — | When true, includes all default files (package.json, configuration files, etc.) that would be part of a complete deployment. When false or omitted, returns only the generated source files. |
v0_chats_favorite
Favorite Chat Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat to update. Provided as a path parameter. |
isFavorite | boolean | Yes | — | Specifies whether the chat should be marked as a favorite. - "true": mark as favorite - "false": remove from favorites |
v0_chats_find
Find Chats Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | number | No | — | Specifies the maximum number of chat records to return in a single response. Useful for paginating results when there are many chats. |
offset | number | No | — | Determines the starting point for pagination. Used in conjunction with limit to retrieve a specific page of chat results. |
isFavorite | string | No | — | Filters chats by their “favorite” status. Accepts "true" or "false" (as strings, not booleans). - "true": returns only chats marked as favorites. - "false": returns only non-favorite chats. |
vercelProjectId | string | No | — | Filters chats by the linked Vercel project ID. Only returns chats associated with the specified Vercel project. |
branch | string | No | — | Filters chats by the Git branch name. Only returns chats that have an active Git connection with the specified branch as the head. |
v0_chats_find_messages
Find Chat Messages Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat to retrieve messages for. Provided as a path parameter. |
limit | number | No | — | Specifies the maximum number of message records to return in a single response. Useful for paginating results when there are many messages. |
cursor | string | No | — | Base64 encoded cursor containing pagination data |
v0_chats_find_versions
Find Chat Versions Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat to retrieve versions for. Provided as a path parameter. |
limit | number | No | — | Specifies the maximum number of version records to return in a single response. Useful for paginating results when there are many versions. |
cursor | string | No | — | Base64 encoded cursor containing pagination data |
v0_chats_fork
Fork Chat Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat to fork. Provided as a path parameter. |
privacy | string | No | — | Determines the privacy setting of the forked chat. This can control whether the chat is visible only to the user, to team members, or is public. |
versionId | string | No | — | The identifier of the specific chat version to fork from. If omitted, the latest version will be used. |
v0_chats_get_by_id
Get Chat Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat to retrieve. Must be provided as a path parameter. |
v0_chats_get_message
Get Chat Message Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat containing the message. Provided as a path parameter. |
messageId | string | Yes | — | The unique identifier of the message to retrieve. Provided as a path parameter. |
v0_chats_get_version
Get Chat Version Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat containing the version. Provided as a path parameter. |
versionId | string | Yes | — | The unique identifier of the version to retrieve. Provided as a path parameter. |
includeDefaultFiles | string | No | — | 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. |
v0_chats_init
Initialize Chat Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatPrivacy | string | No | — | Controls the visibility of the chat. Defines whether the chat is private, shared with a team, or publicly accessible. |
metadata | object | No | — | Arbitrary key-value data to attach to the chat. Useful for storing additional data about the chat, such as external user IDs. |
name | string | No | — | A user-defined name for the chat. Helps identify or describe the purpose of the chat session in the UI or API responses. |
projectId | string | No | — | Associates the chat with a specific project. Useful for organizing and grouping chats in a workspace. |
v0_chats_resolve_task
Resolve Task Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat containing the pending task. Provided as a path parameter. |
modelConfiguration | object | No | — | Overrides for the model behavior. |
responseMode | string | No | — | Controls how the response is delivered. - "sync": The response is returned immediately with the HTTP request. - "async": Returns a message placeholder immediately; use getById to poll for completion status and final output. - "experimental_stream": Returns content parts as Server-Sent Events for real-time streaming. |
task | object | Yes | — | The task resolution data. The latest message in the active chat fork must be an assistant message blocked on the matching task type. |
v0_chats_resume
Resume Message Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat containing the message to resume. Provided as a path parameter. |
messageId | string | Yes | — | The identifier of the specific message to resume. Provided as a path parameter. |
v0_chats_send_message
Send Message Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat to send the message to. Provided as a path parameter. |
action | object | No | — | An optional action to perform. Use fix-with-v0 to trigger automatic error fixing — the message should contain the error logs or context to fix. |
attachedSkillIds | string[] | No | — | Array of skill IDs (from skills.sh) to attach to this message. Skills provide domain-specific knowledge and instructions that guide the AI. Maximum 3 skills per chat. |
attachments | object[] | No | — | A list of files or assets to include with the message. |
mcpServerIds | string[] | No | — | Array of MCP server IDs to enable for this message. When provided, only the specified servers will be used. When omitted, falls back to the user’s enabled MCP servers. |
message | string | Yes | — | The prompt or instruction to send to the model as part of the chat. |
modelConfiguration | object | No | — | Overrides for the model behavior. |
responseMode | string | No | — | Controls how the response is delivered. - "sync": The response is returned immediately with the HTTP request. - "async": Returns a message placeholder immediately; use getById to poll for completion status and final output. - "experimental_stream": Returns content parts as Server-Sent Events for real-time streaming. |
system | string | No | — | Provides system-level context or background for the chat. This is typically used to specify frameworks, tools, or development environments relevant to the task. |
v0_chats_stop
Stop Message Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat containing the message to stop. Provided as a path parameter. |
messageId | string | Yes | — | The identifier of the specific message to stop. Provided as a path parameter. |
v0_chats_update
Update Chat Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat to update. Provided as a path parameter. |
metadata | object | No | — | Arbitrary key-value data to attach to the chat. Useful for storing additional data about the chat, such as external user IDs. Metadata added will be merged with existing attributes. Pass null as the value to delete a specific key, or pass null instead of an object to delete all existing metadata. |
name | string | No | — | A new name to assign to the chat. Helps with identification and organization. |
privacy | string | No | — | Sets the privacy level of the chat. |
v0_chats_update_version
Update Chat Version Files Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
chatId | string | Yes | — | The unique identifier of the chat containing the version to update. Provided as a path parameter. |
versionId | string | Yes | — | The unique identifier of the version (block) to update. Provided as a path parameter. |
files | object[] | Yes | — | Array of files to update with their new content |

