# V0

v0 is an AI-powered web development assistant built by Vercel, designed to generate real, production-ready code for modern web applications.

- **Category:** artificial intelligence
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 44
- **Triggers:** 0
- **Slug:** `V0`
- **Version:** 20260312_00

## Tools

### Assign Chat To Project

**Slug:** `V0_ASSIGN_CHAT_TO_PROJECT`

Tool to assign a chat to a project. Use when you need to group a conversation under a shared project context for better organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chatId` | string | Yes | The ID of the chat to assign to the project |
| `projectId` | string | Yes | The ID of the project to assign the chat to |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### V0 Chat Completions

**Slug:** `V0_CHAT_COMPLETIONS`

Tool to generate a chat model response given a list of messages. Use when you need AI-powered conversational replies via the v0 API.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `model` | string | No | Model ID to use. Available: 'v0-1.5-md' (everyday tasks, UI generation), 'v0-1.5-lg' (advanced reasoning), 'v0-1.0-md' (legacy). Default: 'v0-1.5-md'. |
| `tools` | array | No | Tool/function definitions the model may call. Each tool should have 'type': 'function' and a 'function' object with 'name', 'description', and 'parameters' (JSON Schema). |
| `stream` | boolean | No | Whether to stream the response. Note: Streaming is not supported by this action; set to False or omit. |
| `messages` | array | Yes | Conversation history as a list of messages. Each message requires 'role' (user/assistant/system) and 'content' (text string or content blocks for images). |
| `tool_choice` | string | No | Controls which tool is called. Use 'auto' (model decides), 'none' (no tool), or {'type': 'function', 'function': {'name': '<name>'}} to force a specific tool. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Webhook

**Slug:** `V0_CREATE_HOOK_V0`

Tool to create a new webhook subscription for receiving event notifications. Use when you need to listen for chat or message events from v0.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The target URL to receive webhook payloads. Must be a valid HTTP/HTTPS endpoint |
| `name` | string | Yes | A human-readable name for the webhook |
| `chatId` | string | No | Optional chat ID to scope the webhook to a specific chat. If omitted, webhook receives events from all chats |
| `events` | array | Yes | Array of event types to subscribe to. Choose from: chat.created, chat.updated, chat.deleted, message.created, message.updated, message.deleted, message.finished |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create V0 Project

**Slug:** `V0_CREATE_PROJECT`

Tool to create a new v0 project container for chats and code generation. Use when you need to start a clean project with specific configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `icon` | string | No | Icon identifier or emoji for the project |
| `name` | string | Yes | Name of the project (required) |
| `privacy` | string ("private" | "team") | No | Privacy setting for the project: 'private' or 'team' |
| `description` | string | No | Description of the project |
| `instructions` | string | No | Additional instructions or context for the project. Maximum length: 1000 characters |
| `vercelProjectId` | string | No | ID of an existing Vercel project to link with this v0 project |
| `environmentVariables` | array | No | List of environment variables for the project. Each item must have 'key' and 'value' fields |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Project Environment Variables

**Slug:** `V0_CREATE_PROJECT_ENV_VARS`

Tool to create new environment variables for a v0 project. Use when you need to add environment variables to a project. By default, fails if any keys already exist unless upsert is set to true.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `upsert` | boolean | No | Whether to overwrite existing environment variables with the same keys. If false, the request will fail if any keys already exist. Defaults to false |
| `decrypted` | string ("true" | "false") | No | Enum for the decrypted query parameter. |
| `projectId` | string | Yes | The unique identifier of the project where environment variables should be created |
| `environmentVariables` | array | Yes | An array of environment variables to create with key and value fields. Each item must have 'key' and 'value' properties |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Vercel Project

**Slug:** `V0_CREATE_VERCEL_PROJECT`

Tool to link a Vercel project to an existing v0 project. Use when you need to enable Vercel-related features and deployment integration for a v0 project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name to assign to the new Vercel project |
| `projectId` | string | Yes | The ID of the v0 project to link to the new Vercel project |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Chat

**Slug:** `V0_DELETE_CHAT`

Tool to permanently delete a specific chat by ID. Use when you need to remove a chat and all its contents irreversibly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chatId` | string | Yes | The unique identifier of the chat to delete. This operation is irreversible and permanently removes the chat and its contents. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Deployment

**Slug:** `V0_DELETE_DEPLOYMENT`

Tool to delete a deployment by ID from Vercel. Use when you need to remove a specific deployment permanently.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `deploymentId` | string | Yes | Unique identifier of the deployment to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Hook

**Slug:** `V0_DELETE_HOOK`

Tool to delete a webhook by its ID. Use when you need to remove a webhook subscription. This action is irreversible.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hookId` | string | Yes | The ID of the webhook to delete. This operation is irreversible. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Project Environment Variables

**Slug:** `V0_DELETE_PROJECT_ENV_VARS_V0`

Tool to delete multiple environment variables from a project by their IDs. Use when you need to remove environment variables from a v0 project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `projectId` | string | Yes | The unique identifier of the project whose environment variables should be deleted |
| `environmentVariableIds` | array | Yes | An array of environment variable IDs to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete V0 Project

**Slug:** `V0_DELETE_V0_PROJECT`

Tool to permanently delete a v0 project by its ID. Use when you need to remove a project and optionally all its associated chats. This operation is irreversible.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `projectId` | string | Yes | The unique identifier of the project to delete. This must be a valid project ID that you have access to |
| `deleteAllChats` | string ("true" | "false") | No | If true, deletes all the chats associated with the given project ID. Deleting is permanent. Defaults to false |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Deploy Project

**Slug:** `V0_DEPLOY_PROJECT`

Tool to deploy a specific v0 chat version to Vercel. Use when you need to create a live deployment with public URLs after generating code via v0.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chatId` | string | Yes | The ID of the chat to deploy |
| `projectId` | string | Yes | The ID of the project to deploy |
| `versionId` | string | Yes | The ID of the specific version to deploy |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Chat Version

**Slug:** `V0_DOWNLOAD_CHAT_VERSION`

Tool to download all files for a specific chat version as a zip or tarball archive. Use when you need to retrieve a complete downloadable archive of a version's files, optionally including deployment configuration files.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chatId` | string | Yes | The unique identifier of the chat containing the version |
| `format` | string ("zip" | "tarball") | No | The archive format for the download. Choose 'zip' for broad compatibility or 'tarball' for Unix/Linux systems |
| `versionId` | string | Yes | The unique identifier of the version to download |
| `includeDefaultFiles` | string ("true" | "false") | 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 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Export Project Code

**Slug:** `V0_EXPORT_PROJECT_CODE`

Tool to export a deployable snapshot of a v0 chat version by retrieving all files (including default/deployment files). Use when you need to get the complete generated code for a specific version, ready for local deployment or artifact creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chatId` | string | Yes | The unique identifier of the chat containing the version to export |
| `versionId` | string | Yes | The unique identifier of the specific version to export |
| `includeDefaultFiles` | string | No | Set to 'true' to include default deployment files (package.json, config files, etc.) for a complete deployable snapshot. Set to 'false' to return only generated source files. Defaults to 'true'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Favorite Chat

**Slug:** `V0_FAVORITE_CHAT`

Tool to mark a chat as favorite or remove the favorite status. Use when you need to organize and quickly access important chats.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chatId` | string | Yes | The unique identifier of the chat to update |
| `isFavorite` | boolean | Yes | Specifies whether the chat should be marked as a favorite. Set to true to mark as favorite, false to remove from favorites |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Find Chats

**Slug:** `V0_FIND_CHATS`

Tool to retrieve a list of chats. Use when you need to list user chats with pagination and optional favorite filtering after authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of chats to return; must be between 0 and 60 |
| `offset` | integer | No | Number of chats to skip before returning results; must be non-negative |
| `isFavorite` | boolean | No | Set to true to filter and return only favorite chats. Omit or set to false to return all chats (favorites and non-favorites). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Find Projects

**Slug:** `V0_FIND_PROJECTS`

Tool to retrieve a list of projects associated with the authenticated user. Use after obtaining a valid API key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Cursor for pagination to return items after this cursor |
| `limit` | integer | No | Maximum number of projects to return; must be >= 1 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Find Vercel Projects

**Slug:** `V0_FIND_VERCEL_PROJECTS`

Tool to retrieve a list of Vercel projects linked to the user's v0 workspace. Use when you need to discover available Vercel projects for deployment or integration purposes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Fork Chat

**Slug:** `V0_FORK_CHAT`

Tool to create a fork (copy) of an existing chat. Use when you need to explore alternative directions without modifying the original conversation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chatId` | string | Yes | The unique identifier of the chat to fork |
| `privacy` | string ("public" | "private" | "team" | "team-edit" | "unlisted") | No | Privacy settings for a chat. |
| `versionId` | string | No | The identifier of the specific chat version to fork from. If omitted, the latest version will be used. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Chat

**Slug:** `V0_GET_CHAT`

Tool to retrieve the full details of a specific chat using its chatId. Use when you need to access chat messages, metadata, and configuration for a specific chat.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chatId` | string | Yes | The unique identifier of the chat to retrieve. Must be provided as a path parameter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Chat Project

**Slug:** `V0_GET_CHAT_PROJECT`

Tool to retrieve the v0 project associated with a given chat. Use when you need to determine the context or scope of a chat session.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chatId` | string | Yes | The ID of the chat to retrieve the associated project for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Deployment Errors

**Slug:** `V0_GET_DEPLOYMENT_ERRORS`

Tool to retrieve errors for a specific deployment. Use when diagnosing and debugging deployment issues.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `deploymentId` | string | Yes | The unique identifier of the deployment to inspect for errors |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Deployment Logs

**Slug:** `V0_GET_DEPLOYMENT_LOGS`

Tool to retrieve logs for a specific deployment. Use when you need to debug or monitor deployment behavior by fetching log entries, optionally filtered by timestamp.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `since` | integer | No | A UNIX timestamp (in seconds) used to filter logs. Returns only log entries generated after the specified time |
| `deploymentId` | string | Yes | The unique identifier of the deployment to retrieve logs for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hook

**Slug:** `V0_GET_HOOK`

Tool to retrieve detailed information about a specific webhook by its ID. Use when you need to inspect webhook configuration, subscribed events, or target URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hookId` | string | Yes | The unique identifier of the hook to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Chat Message

**Slug:** `V0_GET_MESSAGE`

Tool to retrieve detailed information about a specific message within a chat. Use when you need to access message content, metadata, attachments, or model configuration for a known message ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chatId` | string | Yes | The unique identifier of the chat containing the message |
| `messageId` | string | Yes | The unique identifier of the message to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Project by ID

**Slug:** `V0_GET_PROJECT`

Tool to retrieve the details of a specific v0 project by its ID, including associated chats and metadata. Use when you need to inspect project configuration or access related chats.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `projectId` | string | Yes | The unique identifier of the project to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Project Environment Variable

**Slug:** `V0_GET_PROJECT_ENV_VAR`

Tool to retrieve a specific environment variable for a given project by its ID, including its value. Use when you need to get the details of a particular environment variable for a project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `decrypted` | string ("true" | "false") | No | Whether to return decrypted or encrypted environment variable values. |
| `projectId` | string | Yes | The unique identifier of the project that owns the environment variable |
| `environmentVariableId` | string | Yes | The unique identifier of the environment variable to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Rate Limits

**Slug:** `V0_GET_RATE_LIMITS`

Tool to retrieve the current rate limits for the authenticated user. Use when you need to monitor usage limits and avoid throttling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `scope` | string | No | The context or namespace to check rate limits for (e.g., a project slug or feature area). If not provided, returns global rate limits. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Usage Report

**Slug:** `V0_GET_USAGE_REPORT_V0`

Tool to retrieve detailed usage events including costs, models used, and metadata. Use when you need to access usage data from the dashboard, filter by chat/user, or analyze costs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of usage events to return per page. Defaults to 20. |
| `chatId` | string | No | Filter usage events by specific chat ID. Only returns events associated with this chat. |
| `cursor` | string | No | Base64 encoded cursor for pagination. Use the nextCursor from a previous response to fetch the next page of results. |
| `userId` | string | No | Filter usage events by specific user ID. Only returns events associated with this user. |
| `endDate` | string | No | Filter events up to this date (ISO 8601 format). Include events created before or on this date. |
| `messageId` | string | No | Filter usage events by specific message ID. Only returns events associated with this message. |
| `startDate` | string | No | Filter events starting from this date (ISO 8601 format). Include events created on or after this date. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User

**Slug:** `V0_GET_USER`

Tool to retrieve the currently authenticated user's information. Use when you need to get the user's ID, name, email, avatar, or account metadata.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Billing

**Slug:** `V0_GET_USER_BILLING`

Tool to fetch billing usage and quota information for the authenticated user. Use when you need to check the user's billing details or usage metrics. Can be scoped to a specific project or namespace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `scope` | string | No | Filters billing data by a specific scope, such as a project ID or slug |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Plan

**Slug:** `V0_GET_USER_PLAN_V0`

Tool to retrieve the authenticated user's subscription plan details including billing cycle and balance. Use to check plan status and usage limits.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Scopes

**Slug:** `V0_GET_USER_SCOPES`

Tool to retrieve all accessible scopes for the authenticated user, such as personal workspaces or shared teams. Use when you need to understand which workspaces the user can access.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Initialize Chat

**Slug:** `V0_INIT_V0_CHAT`

Tool to initialize a new chat from source content such as files, repositories, registries, zip archives, or templates. Use when you need to start a new v0 chat session with pre-populated content. Initialization uses no tokens.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zip` | object | No | Represents a zip archive to initialize from. |
| `name` | string | No | User-defined identifier for the chat session |
| `repo` | object | No | Represents a Git repository to initialize the chat from. |
| `type` | string ("files" | "repo" | "registry" | "zip" | "template") | No | Initialization source types for the chat. |
| `files` | array | No | Inline file objects with name, content, and optional locked status. Used when type='files' |
| `registry` | object | No | Represents a component registry to initialize from. |
| `projectId` | string | No | Associates chat with a specific project ID |
| `templateId` | string | No | Template ID to initialize from. Used when type='template' |
| `chatPrivacy` | string ("public" | "private" | "team" | "team-edit" | "unlisted") | No | Privacy settings for chat visibility. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Chat Versions

**Slug:** `V0_LIST_CHAT_VERSIONS`

Tool to retrieve all versions (iterations) for a specific chat, ordered by creation date (newest first). Use when you need to view the history of a chat's generated versions with cursor-based pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Specifies the maximum number of version records to return in a single response. Useful for paginating results when there are many versions. |
| `chatId` | string | Yes | The unique identifier of the chat to retrieve versions for |
| `cursor` | string | No | Base64 encoded cursor containing pagination data. Use the nextCursor value from a previous response to retrieve the next page of results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Deployments

**Slug:** `V0_LIST_DEPLOYMENTS`

Tool to retrieve a list of deployments for a given project, chat, and version. Use when you need to check existing deployments for specific project versions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chatId` | string | Yes | The ID of the chat to find deployments for |
| `projectId` | string | Yes | The ID of the project to find deployments for |
| `versionId` | string | Yes | The ID of the version to find deployments for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Hooks

**Slug:** `V0_LIST_HOOKS`

Tool to retrieve all webhooks tied to chat events or deployments. Use when you need to list configured webhooks after authentication.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Messages

**Slug:** `V0_LIST_MESSAGES`

Tool to retrieve all messages within a specific chat. Use when you need to list messages with content, role, and type information. Supports pagination for chats with many messages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of message records to return in a single response. Useful for paginating results when there are many messages. |
| `chatId` | string | Yes | The unique identifier of the chat to retrieve messages for |
| `cursor` | string | No | Base64 encoded cursor containing pagination data. Use the nextCursor from a previous response to fetch the next page of results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Project Environment Variables

**Slug:** `V0_LIST_PROJECT_ENV_VARS`

Tool to retrieve all environment variables for a project with optional decryption. Use when you need to view project configuration or secrets.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `decrypted` | string ("true" | "false") | No | Enum for decrypted parameter options. |
| `projectId` | string | Yes | The unique identifier of the project whose environment variables should be retrieved |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Chat

**Slug:** `V0_UPDATE_CHAT`

Tool to update metadata of an existing v0 chat. Use when you need to rename a chat or change its privacy setting after creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | A new name to assign to the chat. Helps with identification and organization |
| `chatId` | string | Yes | The unique identifier of the chat to update |
| `privacy` | string ("public" | "private" | "team" | "team-edit" | "unlisted") | No | Privacy settings for a chat. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Chat Version Files

**Slug:** `V0_UPDATE_CHAT_VERSION`

Tool to update source files of a specific chat version. Use when you need to manually edit generated files through the API.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | Yes | Array of files to update with their new content. Each file must have 'name' and 'content' fields |
| `chatId` | string | Yes | The unique identifier of the chat containing the version to update |
| `versionId` | string | Yes | The unique identifier of the version (block) to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update V0 Webhook

**Slug:** `V0_UPDATE_HOOK`

Tool to update the configuration of an existing webhook, including its name, event subscriptions, or target URL. Use when you need to modify webhook settings after creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | A new URL to send webhook payloads to. Must be a valid URI |
| `name` | string | No | A new name for the hook |
| `events` | array | No | Updated list of event types to subscribe to. Choose from: chat.created, chat.updated, chat.deleted, message.created, message.updated, message.deleted, message.finished |
| `hookId` | string | Yes | The ID of the webhook to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update V0 Project

**Slug:** `V0_UPDATE_PROJECT`

Tool to update the metadata of an existing v0 project using its projectId. Use when you need to change the project name, description, instructions, or privacy setting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | A new name to assign to the project. Helps with identification and organization |
| `privacy` | string ("private" | "team") | No | Privacy settings for a v0 project. |
| `projectId` | string | Yes | The unique identifier of the project to update |
| `description` | string | No | A new description to assign to the project. Helps with identification and organization |
| `instructions` | string | No | Guidance or goals that provide context for the model when working within the project |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Project Environment Variables

**Slug:** `V0_UPDATE_PROJECT_ENV_VARS`

Tool to update environment variables for a v0 project. Use when you need to modify the values of existing environment variables.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `decrypted` | string ("true" | "false") | No | Whether to return decrypted values in the response. Defaults to false (encrypted) |
| `projectId` | string | Yes | The unique identifier of the project whose environment variables should be updated |
| `environmentVariables` | array | Yes | An array of environment variables to update. Each item must have 'id' and 'value' fields |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |