> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# v0-chats

> v0 Chats - Create, manage, and interact with AI code generation chats

**Server path:** `/v0-chats` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                              | Description               |
| ----------------------------------------------------------------- | ------------------------- |
| [`v0_chats_create`](#v0_chats_create)                             | Create Chat               |
| [`v0_chats_delete`](#v0_chats_delete)                             | Delete Chat               |
| [`v0_chats_delete_version_files`](#v0_chats_delete_version_files) | Delete Chat Version Files |
| [`v0_chats_download_version`](#v0_chats_download_version)         | Download version files    |
| [`v0_chats_favorite`](#v0_chats_favorite)                         | Favorite Chat             |
| [`v0_chats_find`](#v0_chats_find)                                 | Find Chats                |
| [`v0_chats_find_messages`](#v0_chats_find_messages)               | Find Chat Messages        |
| [`v0_chats_find_versions`](#v0_chats_find_versions)               | Find Chat Versions        |
| [`v0_chats_fork`](#v0_chats_fork)                                 | Fork Chat                 |
| [`v0_chats_get_by_id`](#v0_chats_get_by_id)                       | Get Chat                  |
| [`v0_chats_get_message`](#v0_chats_get_message)                   | Get Chat Message          |
| [`v0_chats_get_version`](#v0_chats_get_version)                   | Get Chat Version          |
| [`v0_chats_init`](#v0_chats_init)                                 | Initialize Chat           |
| [`v0_chats_resolve_task`](#v0_chats_resolve_task)                 | Resolve Task              |
| [`v0_chats_resume`](#v0_chats_resume)                             | Resume Message            |
| [`v0_chats_send_message`](#v0_chats_send_message)                 | Send Message              |
| [`v0_chats_stop`](#v0_chats_stop)                                 | Stop Message              |
| [`v0_chats_update`](#v0_chats_update)                             | Update Chat               |
| [`v0_chats_update_version`](#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    | null     | 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.                                                                                                                                                                     |                                                                                                                             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "attachedSkillIds": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "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": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "url": {
              "type": "string",
              "description": "The url value"
            }
          },
          "required": [
            "url"
          ]
        },
        "description": "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": {
        "type": "string",
        "description": "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.",
        "enum": [
          "public",
          "private",
          "team-edit",
          "team",
          "unlisted"
        ]
      },
      "designSystemId": {
        "type": [
          "string",
          "null"
        ],
        "description": "The ID of a design system to apply to this chat. Design systems provide consistent styling and components for generated UI."
      },
      "mcpServerIds": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "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": {
        "type": "string",
        "description": "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": {
        "type": "object",
        "description": "Arbitrary key-value data to attach to the chat. Useful for storing additional data about the chat, such as external user IDs."
      },
      "modelConfiguration": {
        "type": "object",
        "description": "Settings that control how the model behaves in the chat.",
        "properties": {
          "modelId": {
            "type": "string",
            "description": "Deprecated Model ID field preserved for backward compatibility.",
            "enum": [
              "v0-auto",
              "v0-opus-4.7",
              "v0-mini",
              "v0-pro",
              "v0-max",
              "v0-max-fast"
            ]
          },
          "imageGenerations": {
            "type": "boolean",
            "description": "Enables image generations to generate up to 5 images per version."
          },
          "thinking": {
            "type": "boolean",
            "description": "Enables thinking to generate a response in multiple steps."
          }
        }
      },
      "projectId": {
        "type": "string",
        "description": "Associates the chat with a specific project in your workspace. Helps organize and group related chats under a common project context."
      },
      "responseMode": {
        "type": "string",
        "description": "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.",
        "enum": [
          "sync",
          "async",
          "experimental_stream"
        ]
      },
      "system": {
        "type": "string",
        "description": "Provides system-level context or background for the chat. This is typically used to specify frameworks, tools, or development environments relevant to the task."
      }
    },
    "required": [
      "PCID",
      "message"
    ]
  }
  ```
</Expandable>

***

## 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. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat to delete. This must be passed as a path parameter in the URL."
      }
    },
    "required": [
      "PCID",
      "chatId"
    ]
  }
  ```
</Expandable>

***

## 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"]) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat containing the version to delete files from."
      },
      "versionId": {
        "type": "string",
        "description": "The unique identifier of the version (block) to delete files from."
      },
      "filePaths": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Array of file paths to delete (e.g., [\"components/test.tsx\", \"lib/utils.ts\"])"
      }
    },
    "required": [
      "PCID",
      "chatId",
      "versionId",
      "filePaths"
    ]
  }
  ```
</Expandable>

***

## 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. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat containing the version. Provided as a path parameter."
      },
      "versionId": {
        "type": "string",
        "description": "The unique identifier of the version to download. Provided as a path parameter."
      },
      "format": {
        "type": "string",
        "description": "The archive format for the download. Choose \"zip\" for broad compatibility or \"tarball\" for Unix/Linux systems.",
        "enum": [
          "zip",
          "tarball"
        ]
      },
      "includeDefaultFiles": {
        "type": "string",
        "description": "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.",
        "enum": [
          "true",
          "false"
        ]
      }
    },
    "required": [
      "PCID",
      "chatId",
      "versionId"
    ]
  }
  ```
</Expandable>

***

## 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 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat to update. Provided as a path parameter."
      },
      "isFavorite": {
        "type": "boolean",
        "description": "Specifies whether the chat should be marked as a favorite.  - `\"true\"`: mark as favorite - `\"false\"`: remove from favorites"
      }
    },
    "required": [
      "PCID",
      "chatId",
      "isFavorite"
    ]
  }
  ```
</Expandable>

***

## 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.                                                                     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "limit": {
        "type": "number",
        "description": "Specifies the maximum number of chat records to return in a single response. Useful for paginating results when there are many chats."
      },
      "offset": {
        "type": "number",
        "description": "Determines the starting point for pagination. Used in conjunction with limit to retrieve a specific page of chat results."
      },
      "isFavorite": {
        "type": "string",
        "description": "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.",
        "enum": [
          "true",
          "false"
        ]
      },
      "vercelProjectId": {
        "type": "string",
        "description": "Filters chats by the linked Vercel project ID. Only returns chats associated with the specified Vercel project."
      },
      "branch": {
        "type": "string",
        "description": "Filters chats by the Git branch name. Only returns chats that have an active Git connection with the specified branch as the head."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## 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                                                                                            |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat to retrieve messages for. Provided as a path parameter."
      },
      "limit": {
        "type": "number",
        "description": "Specifies the maximum number of message records to return in a single response. Useful for paginating results when there are many messages."
      },
      "cursor": {
        "type": "string",
        "description": "Base64 encoded cursor containing pagination data"
      }
    },
    "required": [
      "PCID",
      "chatId"
    ]
  }
  ```
</Expandable>

***

## 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                                                                                            |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat to retrieve versions for. Provided as a path parameter."
      },
      "limit": {
        "type": "number",
        "description": "Specifies the maximum number of version records to return in a single response. Useful for paginating results when there are many versions."
      },
      "cursor": {
        "type": "string",
        "description": "Base64 encoded cursor containing pagination data"
      }
    },
    "required": [
      "PCID",
      "chatId"
    ]
  }
  ```
</Expandable>

***

## 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.                                           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat to fork. Provided as a path parameter."
      },
      "privacy": {
        "type": "string",
        "description": "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.",
        "enum": [
          "public",
          "private",
          "team",
          "team-edit",
          "unlisted"
        ]
      },
      "versionId": {
        "type": "string",
        "description": "The identifier of the specific chat version to fork from. If omitted, the latest version will be used."
      }
    },
    "required": [
      "PCID",
      "chatId"
    ]
  }
  ```
</Expandable>

***

## 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. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat to retrieve. Must be provided as a path parameter."
      }
    },
    "required": [
      "PCID",
      "chatId"
    ]
  }
  ```
</Expandable>

***

## 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.         |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat containing the message. Provided as a path parameter."
      },
      "messageId": {
        "type": "string",
        "description": "The unique identifier of the message to retrieve. Provided as a path parameter."
      }
    },
    "required": [
      "PCID",
      "chatId",
      "messageId"
    ]
  }
  ```
</Expandable>

***

## 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. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat containing the version. Provided as a path parameter."
      },
      "versionId": {
        "type": "string",
        "description": "The unique identifier of the version to retrieve. Provided as a path parameter."
      },
      "includeDefaultFiles": {
        "type": "string",
        "description": "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.",
        "enum": [
          "true",
          "false"
        ]
      }
    },
    "required": [
      "PCID",
      "chatId",
      "versionId"
    ]
  }
  ```
</Expandable>

***

## 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.                                                                     |
| `files`        | any\[]  | No       | —       | An array of inline file objects used to initialize the chat. Each object must contain a file `name` and its `content`.                                                                    |
| `lockAllFiles` | boolean | No       | —       | Whether to lock all files from the zip archive to prevent AI from overwriting them during generation                                                                                      |
| `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.                                                                                     |
| `registry`     | object  | No       | —       | Allows initialization from a predefined component or code registry. Includes the registry source and identifier for the desired component/module.                                         |
| `repo`         | object  | No       | —       | Specifies a repository source for initialization. Supports both public and private GitHub repositories. For private repositories, ensure your GitHub account is connected through Vercel. |
| `templateId`   | string  | No       | —       | The ID of the template to initialize the chat from. This should be a valid template ID from the v0 template system.                                                                       |
| `type`         | string  | No       | —       | Specifies the initialization method. For this endpoint, it defines the source of content being used to initialize the chat.                                                               |
| `zip`          | object  | No       | —       | Provides a zipped bundle of files as the input source. Typically includes a base64-encoded archive or a remote URL reference.                                                             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatPrivacy": {
        "type": "string",
        "description": "Controls the visibility of the chat. Defines whether the chat is private, shared with a team, or publicly accessible.",
        "enum": [
          "public",
          "private",
          "team-edit",
          "team",
          "unlisted"
        ]
      },
      "files": {
        "type": "array",
        "description": "An array of inline file objects used to initialize the chat. Each object must contain a file `name` and its `content`."
      },
      "lockAllFiles": {
        "type": "boolean",
        "description": "Whether to lock all files from the zip archive to prevent AI from overwriting them during generation"
      },
      "metadata": {
        "type": "object",
        "description": "Arbitrary key-value data to attach to the chat. Useful for storing additional data about the chat, such as external user IDs."
      },
      "name": {
        "type": "string",
        "description": "A user-defined name for the chat. Helps identify or describe the purpose of the chat session in the UI or API responses."
      },
      "projectId": {
        "type": "string",
        "description": "Associates the chat with a specific project. Useful for organizing and grouping chats in a workspace."
      },
      "registry": {
        "type": "object",
        "description": "Allows initialization from a predefined component or code registry. Includes the registry source and identifier for the desired component/module.",
        "properties": {
          "url": {
            "type": "string",
            "description": "The url value"
          }
        },
        "required": [
          "url"
        ]
      },
      "repo": {
        "type": "object",
        "description": "Specifies a repository source for initialization. Supports both public and private GitHub repositories. For private repositories, ensure your GitHub account is connected through Vercel.",
        "properties": {
          "url": {
            "type": "string",
            "description": "The url value"
          },
          "branch": {
            "type": "string",
            "description": "The branch value"
          }
        },
        "required": [
          "url"
        ]
      },
      "templateId": {
        "type": "string",
        "description": "The ID of the template to initialize the chat from. This should be a valid template ID from the v0 template system."
      },
      "type": {
        "type": "string",
        "description": "Specifies the initialization method. For this endpoint, it defines the source of content being used to initialize the chat."
      },
      "zip": {
        "type": "object",
        "description": "Provides a zipped bundle of files as the input source. Typically includes a base64-encoded archive or a remote URL reference.",
        "properties": {
          "url": {
            "type": "string",
            "description": "The url value"
          }
        },
        "required": [
          "url"
        ]
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## 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.                                                                                                                                                                                                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat containing the pending task. Provided as a path parameter."
      },
      "modelConfiguration": {
        "type": "object",
        "description": "Overrides for the model behavior.",
        "properties": {
          "modelId": {
            "type": "string",
            "description": "Deprecated Model ID field preserved for backward compatibility.",
            "enum": [
              "v0-auto",
              "v0-opus-4.7",
              "v0-mini",
              "v0-pro",
              "v0-max",
              "v0-max-fast"
            ]
          },
          "imageGenerations": {
            "type": "boolean",
            "description": "Enables image generations to generate up to 5 images per version."
          },
          "thinking": {
            "type": "boolean",
            "description": "Enables thinking to generate a response in multiple steps."
          }
        }
      },
      "responseMode": {
        "type": "string",
        "description": "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.",
        "enum": [
          "sync",
          "async",
          "experimental_stream"
        ]
      },
      "task": {
        "description": "The task resolution data. The latest message in the active chat fork must be an assistant message blocked on the matching task type."
      }
    },
    "required": [
      "PCID",
      "chatId",
      "task"
    ]
  }
  ```
</Expandable>

***

## 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.                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat containing the message to resume. Provided as a path parameter."
      },
      "messageId": {
        "type": "string",
        "description": "The identifier of the specific message to resume. Provided as a path parameter."
      }
    },
    "required": [
      "PCID",
      "chatId",
      "messageId"
    ]
  }
  ```
</Expandable>

***

## 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.                                                                                                                                                                     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat to send the message to. Provided as a path parameter."
      },
      "action": {
        "type": "object",
        "description": "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.",
        "properties": {
          "type": {
            "type": "string",
            "description": "The type value"
          }
        },
        "required": [
          "type"
        ]
      },
      "attachedSkillIds": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "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": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "url": {
              "type": "string",
              "description": "The url value"
            }
          },
          "required": [
            "url"
          ]
        },
        "description": "A list of files or assets to include with the message."
      },
      "mcpServerIds": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "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": {
        "type": "string",
        "description": "The prompt or instruction to send to the model as part of the chat."
      },
      "modelConfiguration": {
        "type": "object",
        "description": "Overrides for the model behavior.",
        "properties": {
          "modelId": {
            "type": "string",
            "description": "Deprecated Model ID field preserved for backward compatibility.",
            "enum": [
              "v0-auto",
              "v0-opus-4.7",
              "v0-mini",
              "v0-pro",
              "v0-max",
              "v0-max-fast"
            ]
          },
          "imageGenerations": {
            "type": "boolean",
            "description": "Enables image generations to generate up to 5 images per version."
          },
          "thinking": {
            "type": "boolean",
            "description": "Enables thinking to generate a response in multiple steps."
          }
        }
      },
      "responseMode": {
        "type": "string",
        "description": "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.",
        "enum": [
          "sync",
          "async",
          "experimental_stream"
        ]
      },
      "system": {
        "type": "string",
        "description": "Provides system-level context or background for the chat. This is typically used to specify frameworks, tools, or development environments relevant to the task."
      }
    },
    "required": [
      "PCID",
      "chatId",
      "message"
    ]
  }
  ```
</Expandable>

***

## 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.                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat containing the message to stop. Provided as a path parameter."
      },
      "messageId": {
        "type": "string",
        "description": "The identifier of the specific message to stop. Provided as a path parameter."
      }
    },
    "required": [
      "PCID",
      "chatId",
      "messageId"
    ]
  }
  ```
</Expandable>

***

## 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.                                                                                                                                                                                                                                                                           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat to update. Provided as a path parameter."
      },
      "metadata": {
        "type": "object",
        "description": "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": {
        "type": "string",
        "description": "A new name to assign to the chat. Helps with identification and organization."
      },
      "privacy": {
        "type": "string",
        "description": "Sets the privacy level of the chat.",
        "enum": [
          "public",
          "private",
          "team",
          "team-edit",
          "unlisted"
        ]
      }
    },
    "required": [
      "PCID",
      "chatId"
    ]
  }
  ```
</Expandable>

***

## 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                                                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "chatId": {
        "type": "string",
        "description": "The unique identifier of the chat containing the version to update. Provided as a path parameter."
      },
      "versionId": {
        "type": "string",
        "description": "The unique identifier of the version (block) to update. Provided as a path parameter."
      },
      "files": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "The full file path including extension (e.g., \"components/test.tsx\")"
            },
            "content": {
              "type": "string",
              "description": "The new content for the file"
            },
            "locked": {
              "type": "boolean",
              "description": "Whether to lock or unlock the file to prevent AI from overwriting it during generation"
            }
          },
          "required": [
            "name",
            "content"
          ]
        },
        "description": "Array of files to update with their new content"
      }
    },
    "required": [
      "PCID",
      "chatId",
      "versionId",
      "files"
    ]
  }
  ```
</Expandable>