Sign in

v14

latestOpenAPI 3.0.32026-08-04377889.4 MB
projects

Create a new project

Allows to create a new project with the provided configuration. It only requires the project name but more configuration can be provided to override the defaults.

post/v11/projects

Query parameters

teamIdstring
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Request body

enablePreviewFeedbackboolean nullable

Opt-in to preview toolbar on the project level

enableProductionFeedbackboolean nullable

Opt-in to production toolbar on the project level

previewDeploymentsDisabledboolean nullable

Specifies whether preview deployments are disabled for this project.

previewDeploymentSuffixstring nullable

Custom domain suffix for preview deployments. Takes precedence over team-level suffix. Must be a domain owned by the team.

buildCommandstring nullable

The build command for this project. When null is used this value will be automatically detected

commandForIgnoringBuildStepstring nullable
devCommandstring nullable

The dev command for this project. When null is used this value will be automatically detected

{"stackTrail":"paths:/v11/projects:post:requestBody:content:application/json:schema:properties:framework","oasType":"schema","type":"unknown","description":"The framework that is being used for this project. When `null` is used no framework is selected"}
installCommandstring nullable

The install command for this project. When null is used this value will be automatically detected

namestring required

The desired name for the project

skipGitConnectDuringLinkboolean

Opts-out of the message prompting a CLI user to connect a Git repository in vercel link.

outputDirectorystring nullable

The output directory of the project. When null is used this value will be automatically detected

publicSourceboolean nullable

Deprecated. Accepted for backwards compatibility but ignored.

rootDirectorystring nullable

The name of a directory or relative path to the source code of your project. When null is used it will default to the project root

serverlessFunctionRegionstring nullable

The region to deploy Serverless Functions in this project

serverlessFunctionZeroConfigFailoverboolean

Specifies whether Zero Config Failover is enabled for this project.

enableAffectedProjectsDeploymentsboolean

Opt-in to skip deployments when there are no changes to the root directory and its dependencies

Example request

{
  "name": "a-project-name"
}

Response

The project was successfuly created

accountIdstring required
appliedCve55182Migrationfalse | true
autoExposeSystemEnvsfalse | true
autoAssignCustomDomainsfalse | true
autoAssignCustomDomainsUpdatedBystring
buildCommandstring nullable
commandForIgnoringBuildStepstring nullable
connectConfigurationIdstring nullable
connectBuildsEnabledfalse | true
passiveConnectConfigurationIdstring nullable
createdAtnumber
customerSupportCodeVisibilityfalse | true
devCommandstring nullable
directoryListingfalse | true required
installCommandstring nullable
framework'actix-web' | 'angular' | 'ash' | 'astro' | 'axum' | 'blitzjs' | 'brunch' | 'bun' | 'container' | 'create-react-app' | 'django' | 'docusaurus' | 'docusaurus-2' | 'dojo' | 'eleventy' | 'elysia' | 'ember' | 'eve' | 'express' | 'fastapi' | 'fasthtml' | 'fastify' | 'flask' | 'gatsby' | 'go' | 'gridsome' | 'h3' | 'hexo' | 'hono' | 'hugo' | 'hydrogen' | 'ionic-angular' | 'ionic-react' | 'jekyll' | 'koa' | 'mastra' | 'middleman' | 'nestjs' | 'nextjs' | 'nitro' | 'node' | 'nuxtjs' | 'parcel' | 'polymer' | 'preact' | 'python' | 'react-router' | 'redwoodjs' | 'remix' | 'ruby' | 'rust' | 'saber' | 'sanity' | 'sanity-v2' | 'sapper' | 'scully' | 'services' | 'solidstart' | 'solidstart-1' | 'stencil' | 'storybook' | 'svelte' | 'sveltekit' | 'sveltekit-1' | 'tanstack-start' | 'tanstack-start-lovable' | 'umijs' | 'vite' | 'vitepress' | 'vue' | 'vuepress' | 'xmcp' | 'zola' | 'null' nullable
gitForkProtectionfalse | true
gitLFSfalse | true
idstring required
namestring required
nodeVersion'10.x' | '12.x' | '14.x' | '16.x' | '18.x' | '20.x' | '22.x' | '24.x' | '8.10.x' required
outputDirectorystring nullable
passwordProtectionobject nullable
productionDeploymentsFastLanefalse | true
rootDirectorystring nullable
serverlessFunctionZeroConfigFailoverfalse | true
skewProtectionBoundaryAtnumber
skewProtectionMaxAgenumber
skewProtectionAllowedDomainsstring[]
skipGitConnectDuringLinkfalse | true
sourceFilesOutsideRootDirectoryfalse | true
enableAffectedProjectsDeploymentsfalse | true
enableExternalRewriteCachingfalse | true
targetsobject
transferCompletedAtnumber
transferStartedAtnumber
transferToAccountIdstring
transferredFromAccountIdstring
updatedAtnumber
livefalse | true
enablePreviewFeedbackfalse | true | null nullable
enableProductionFeedbackfalse | true | null nullable
lastRollbackTargetobject nullable
protectionBypassobject
hasActiveBranchesfalse | true
pausedfalse | true
concurrencyBucketNamestring
tierstring
v0false | true
v0Createdfalse | true
hasDeploymentsfalse | true
protectedSourcemapsfalse | true
avatarstring nullable

Example response

{
  "crons": {
    "definitions": [
      {
        "host": "vercel.com",
        "path": "/api/crons/sync-something?hello=world",
        "schedule": "0 0 * * *"
      }
    ]
  },
  "rollingRelease": {
    "target": "production",
    "stages": [
      {
        "targetPercentage": 25,
        "duration": 600
      }
    ]
  }
}