projects

Create Project

Creates a new v0 project with an optional description, icon, environment variables, and instructions. Projects help organize chats and manage context.

post/projects

Request body

namestring required

The name of the project.

descriptionstring

A brief summary of the project’s purpose.

iconstring

An icon identifier to visually represent the project.

instructionsstring

Guidance or goals that provide context for the model when working within the project.

vercelProjectIdstring

The ID of an existing Vercel project to link to. If not provided, a new Vercel project will be created.

privacy'private' | 'team'

The privacy setting for the project. For user accounts, this is always "private". For team/enterprise accounts, this can be either "private" or "team".

Response

Success

idstring required

A unique identifier for the project.

object'project' required

Fixed value identifying this object as a project.

namestring required

The name of the project as defined by the user.

privacy'private' | 'team' required

The privacy setting for the project - either private or team.

vercelProjectIdstring

Optional ID of the linked Vercel project, if connected.

createdAtstring date-time required

The ISO timestamp representing when the project was created.

updatedAtstring date-time

The ISO timestamp of the most recent update, if available.

apiUrlstring uri required

The API endpoint URL for accessing this project programmatically.

webUrlstring uri required

The web URL where the project can be viewed or managed.

descriptionstring

The description of the project.

instructionsstring

The instructions for the project.

Changes