mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify-development[bot]
22 lines
1.0 KiB
Plaintext
22 lines
1.0 KiB
Plaintext
---
|
|
title: "Trigger preview deployment"
|
|
description: "Programmatically create or redeploy a preview deployment for a Git branch from CI pipelines, scheduled jobs, or custom internal tooling."
|
|
openapi: "/openapi.json POST /project/preview/{projectId}"
|
|
keywords: ["preview", "preview deployment", "branch preview", "staging"]
|
|
|
|
---
|
|
|
|
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 users open or update pull requests.
|
|
- **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.
|