Skip to main content
POST
/
project
/
preview
/
{projectId}
Trigger preview deployment
curl --request POST \
  --url https://api.mintlify.com/v1/project/preview/{projectId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "branch": "<string>"
}
'
{
  "statusId": "<string>",
  "previewUrl": "<string>"
}

Authorizations

​
Authorization
string
header
required

The Authorization header expects a Bearer token. Use an admin API key (prefixed with mint_). This is a server-side secret key. Generate one on the API keys page in your dashboard.

Path Parameters

​
projectId
string
required

Your project ID. Can be copied from the API keys page in your dashboard.

Body

application/json
​
branch
string
required

The name of the branch to create a preview deployment for.

Minimum string length: 1

Response

Preview deployment queued successfully

​
statusId
string

The status ID of the triggered preview deployment. Use this with the Get deployment status endpoint to poll for progress.

​
previewUrl
string

The URL where the preview deployment will be accessible.