mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
ed3e4614b4
Generated-By: mintlify-agent Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
25 lines
1.2 KiB
Plaintext
25 lines
1.2 KiB
Plaintext
---
|
|
title: "Trigger preview deployment"
|
|
description: "Create or update a preview deployment for a specific branch to review documentation changes before merging to production."
|
|
openapi: "/openapi.json POST /project/preview/{projectId}"
|
|
keywords: ["preview", "preview deployment", "branch preview", "staging"]
|
|
---
|
|
|
|
<Info>
|
|
Preview deployments are available on [Pro and Enterprise plans](https://mintlify.com/pricing?ref=preview-deployments).
|
|
</Info>
|
|
|
|
Use this endpoint to programmatically create or update a preview deployment for a Git branch. If a preview already exists for the specified branch, the endpoint triggers a redeployment instead of creating a duplicate.
|
|
|
|
The response includes a `statusId` that you can pass to [Get deployment status](/api/update/status) to track the deployment progress.
|
|
|
|
## Use cases
|
|
|
|
- **CI/CD pipelines**: Automatically create preview deployments when pull requests are opened or updated.
|
|
- **Scheduled previews**: Build previews from long-running feature branches on a schedule.
|
|
- **Custom tooling**: Integrate preview creation into internal workflows or Slack bots.
|
|
|
|
## Rate limits
|
|
|
|
This endpoint allows up to 5 requests per minute per organization.
|