Skip to main content
Server path: /v0-chats | Type: Application | PCID required: Yes

Tools

ToolDescription
v0_chats_createCreate Chat
v0_chats_deleteDelete Chat
v0_chats_delete_version_filesDelete Chat Version Files
v0_chats_download_versionDownload version files
v0_chats_favoriteFavorite Chat
v0_chats_findFind Chats
v0_chats_find_messagesFind Chat Messages
v0_chats_find_versionsFind Chat Versions
v0_chats_forkFork Chat
v0_chats_get_by_idGet Chat
v0_chats_get_messageGet Chat Message
v0_chats_get_versionGet Chat Version
v0_chats_initInitialize Chat
v0_chats_resolve_taskResolve Task
v0_chats_resumeResume Message
v0_chats_send_messageSend Message
v0_chats_stopStop Message
v0_chats_updateUpdate Chat
v0_chats_update_versionUpdate Chat Version Files

v0_chats_create

Create Chat Parameters:
ParameterTypeRequiredDefaultDescription
attachedSkillIdsstring[]NoArray 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.
attachmentsobject[]NoA 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.
chatPrivacystringNoDetermines the privacy setting of the chat. This can control whether the chat is visible only to the user, to team members, or is public.
designSystemIdstringNoThe ID of a design system to apply to this chat. Design systems provide consistent styling and components for generated UI.
mcpServerIdsstring[]NoArray 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.
messagestringYesCreates 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.
metadataobjectNoArbitrary key-value data to attach to the chat. Useful for storing additional data about the chat, such as external user IDs.
modelConfigurationobjectNoSettings that control how the model behaves in the chat.
projectIdstringNoAssociates the chat with a specific project in your workspace. Helps organize and group related chats under a common project context.
responseModestringNoControls 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.
systemstringNoProvides 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:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe 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:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat containing the version to delete files from.
versionIdstringYesThe unique identifier of the version (block) to delete files from.
filePathsstring[]YesArray of file paths to delete (e.g., [“components/test.tsx”, “lib/utils.ts”])

v0_chats_download_version

Download version files Parameters:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat containing the version. Provided as a path parameter.
versionIdstringYesThe unique identifier of the version to download. Provided as a path parameter.
formatstringNoThe archive format for the download. Choose “zip” for broad compatibility or “tarball” for Unix/Linux systems.
includeDefaultFilesstringNoWhen 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:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat to update. Provided as a path parameter.
isFavoritebooleanYesSpecifies whether the chat should be marked as a favorite. - "true": mark as favorite - "false": remove from favorites

v0_chats_find

Find Chats Parameters:
ParameterTypeRequiredDefaultDescription
limitnumberNoSpecifies the maximum number of chat records to return in a single response. Useful for paginating results when there are many chats.
offsetnumberNoDetermines the starting point for pagination. Used in conjunction with limit to retrieve a specific page of chat results.
isFavoritestringNoFilters 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.
vercelProjectIdstringNoFilters chats by the linked Vercel project ID. Only returns chats associated with the specified Vercel project.
branchstringNoFilters 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:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat to retrieve messages for. Provided as a path parameter.
limitnumberNoSpecifies the maximum number of message records to return in a single response. Useful for paginating results when there are many messages.
cursorstringNoBase64 encoded cursor containing pagination data

v0_chats_find_versions

Find Chat Versions Parameters:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat to retrieve versions for. Provided as a path parameter.
limitnumberNoSpecifies the maximum number of version records to return in a single response. Useful for paginating results when there are many versions.
cursorstringNoBase64 encoded cursor containing pagination data

v0_chats_fork

Fork Chat Parameters:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat to fork. Provided as a path parameter.
privacystringNoDetermines 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.
versionIdstringNoThe 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:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat to retrieve. Must be provided as a path parameter.

v0_chats_get_message

Get Chat Message Parameters:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat containing the message. Provided as a path parameter.
messageIdstringYesThe unique identifier of the message to retrieve. Provided as a path parameter.

v0_chats_get_version

Get Chat Version Parameters:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat containing the version. Provided as a path parameter.
versionIdstringYesThe unique identifier of the version to retrieve. Provided as a path parameter.
includeDefaultFilesstringNoWhen 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:
ParameterTypeRequiredDefaultDescription
chatPrivacystringNoControls the visibility of the chat. Defines whether the chat is private, shared with a team, or publicly accessible.
metadataobjectNoArbitrary key-value data to attach to the chat. Useful for storing additional data about the chat, such as external user IDs.
namestringNoA user-defined name for the chat. Helps identify or describe the purpose of the chat session in the UI or API responses.
projectIdstringNoAssociates the chat with a specific project. Useful for organizing and grouping chats in a workspace.

v0_chats_resolve_task

Resolve Task Parameters:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat containing the pending task. Provided as a path parameter.
modelConfigurationobjectNoOverrides for the model behavior.
responseModestringNoControls 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.
taskobjectYesThe 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:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat containing the message to resume. Provided as a path parameter.
messageIdstringYesThe identifier of the specific message to resume. Provided as a path parameter.

v0_chats_send_message

Send Message Parameters:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat to send the message to. Provided as a path parameter.
actionobjectNoAn optional action to perform. Use fix-with-v0 to trigger automatic error fixing — the message should contain the error logs or context to fix.
attachedSkillIdsstring[]NoArray 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.
attachmentsobject[]NoA list of files or assets to include with the message.
mcpServerIdsstring[]NoArray 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.
messagestringYesThe prompt or instruction to send to the model as part of the chat.
modelConfigurationobjectNoOverrides for the model behavior.
responseModestringNoControls 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.
systemstringNoProvides 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:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat containing the message to stop. Provided as a path parameter.
messageIdstringYesThe identifier of the specific message to stop. Provided as a path parameter.

v0_chats_update

Update Chat Parameters:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat to update. Provided as a path parameter.
metadataobjectNoArbitrary 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.
namestringNoA new name to assign to the chat. Helps with identification and organization.
privacystringNoSets the privacy level of the chat.

v0_chats_update_version

Update Chat Version Files Parameters:
ParameterTypeRequiredDefaultDescription
chatIdstringYesThe unique identifier of the chat containing the version to update. Provided as a path parameter.
versionIdstringYesThe unique identifier of the version (block) to update. Provided as a path parameter.
filesobject[]YesArray of files to update with their new content