v0 Platform API
Programmatic access to v0.dev's complete development infrastructure
The v0 Platform API provides programmatic access to v0.dev's complete development infrastructure. Create AI-powered development sessions, parse code responses, and run Next.js applications in the browser - all through a unified API.
Available Endpoints
Chats
- Create Chat - 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.
- Find Chats - Retrieves a list of existing chats, with support for pagination and filtering by favorite status. Helps manage and navigate chat history.
- Initialize Chat - Initializes a new chat from source content such as files, repositories, registries, or zip archives. Enables context-rich conversations based on code or assets.
- Delete Chat - Deletes a specific chat based on the provided chatId. This operation is irreversible and permanently removes the chat and its contents.
- Get Chat - Retrieves the full details of a specific chat using its
chatId. Includes messages, metadata, and associated configuration. - Update Chat - Updates the metadata of an existing chat using its
chatId. Supports changes to the chat name and privacy setting. - Favorite Chat - Marks or unmarks a chat as a favorite using its
chatId. This helps with organizing and quickly accessing important chats. - Fork Chat - Creates a new chat fork from a specific version within an existing chat. Useful for branching off alternate directions without modifying the original conversation.
- Find Chat Messages - Retrieves a list of all messages for a specific chat, ordered by creation date (newest first). Supports cursor-based pagination and includes message content, role, and type information.
- Send Message - Creates a new message in an existing chat. Triggers a model response using the provided prompt, with optional attachments and configuration settings.
- Get Chat Message - Retrieves detailed information about a specific message within a chat, including content, files, model configuration, and demo URLs.
- Find Chat Versions - Retrieves a list of all versions (iterations) for a specific chat, ordered by creation date (newest first). Supports cursor-based pagination and includes version status and demo URLs.
- Get Chat Version - Retrieves detailed information about a specific version of a chat, including all files with their content and lock status.
- Update Chat Version Files - Updates the source files of a specific chat version (block) manually. This allows editing generated files directly through the API.
- Resume Message - Resumes processing of a previously interrupted or incomplete message in a chat. Useful for continuing generation when a message was paused or stopped.
Projects
- Get Project by Chat ID - Retrieves the v0 project associated with a given chat. Useful for determining the context or scope of a chat session.
- Find Projects - Returns a list of all v0 projects in your workspace. Useful for browsing or managing projects across different chats or use cases.
- Create Project - Creates a new v0 project with an optional description, icon, environment variables, and instructions. Projects help organize chats and manage context.
- Get Project by ID - Retrieves the details of a specific v0 project by its ID.
- Update Project - Updates the metadata of an existing project using its
projectId. Supports changes to the project name and privacy setting. - Assign Project to Chat - Links an existing v0 project to a specific chat. Helps group conversations under a shared project context.
Deployments
- Find Deployments - Find deployments by project and chat IDs. This will return a list of deployments for the given project and chat IDs.
- Create Deployment - Create a new deployment for a specific chat and version. This will trigger a deployment to Vercel.
- Get Deployment - Get a deployment by ID. This will return the details of the deployment, including the inspector URL, chat ID, project ID, version ID, API URL, and web URL.
- Delete Deployment - Delete a deployment by ID. This will delete the deployment from Vercel.
- Find Deployment Logs - Retrieves logs for a specific deployment. Supports filtering by timestamp to fetch only recent logs.
- Find Deployment Errors - Retrieves a list of errors that occurred during a specific deployment. Useful for diagnosing and debugging deployment issues.
Hooks
- Find Hooks - Retrieves a list of existing hooks in your workspace. Useful for managing active webhooks tied to chat events or deployments.
- Create Hook - Creates a new webhook that listens for specific events. Supports optional association with a chat or project.
- Get Hook - Retrieves the details of a specific webhook using its ID.
- Update Hook - Updates the configuration of an existing webhook, including its name, event subscriptions, or target URL.
- Delete Hook - Deletes a webhook based on its ID. This action is irreversible.
RateLimits
- Find Rate Limit - Retrieves rate limit information for a given scope. Useful for monitoring usage limits and avoiding throttling.
User
- Get User - Retrieves information about the authenticated user, including their ID, name, email, and account metadata.
- Get Billing - Fetches billing usage and quota information for the authenticated user. Can be scoped to a specific context (e.g. project or namespace).
- Get Plan - Returns the current subscription plan for the authenticated user, including tier details and feature limits.
- Get User Scopes - Retrieves all accessible scopes for the authenticated user, such as personal workspaces or shared teams.
Getting Started
The v0 Platform API provides all the infrastructure you need to build AI-powered development experiences. Start with chat creation, add file management, and integrate the frame environment for complete application lifecycle support.
Whether you're building development tools, educational platforms, or internal workflows, the API gives you access to the same infrastructure that powers v0.dev—from AI conversations to running applications in the browser.