Add trigger preview deployment API endpoint

[mintlify]

Summary

• Adds documentation for the new POST /project/preview/{projectId} API endpoint that lets users programmatically create or update preview deployments for a specific Git branch
• Adds the endpoint to the OpenAPI spec, API introduction page, navigation, and cross-references it from the preview deployments guide

Shipped in mintlify/server#4633: a new public API endpoint that mirrors the existing update trigger pattern, enabling customers to create preview deployments via the REST API using their admin API key.

---

Note

Low Risk
Low risk: documentation and OpenAPI-spec updates only, with no runtime/business-logic changes in this repo.

Overview
Adds a new documented admin REST endpoint, POST /project/preview/{projectId}, to programmatically create or redeploy branch preview deployments (returns statusId + previewUrl, with 400/403 cases).

Wires the new endpoint into the docs site by adding api/preview/trigger.mdx, linking it from the API introduction and preview-deployments guide, and exposing it in docs.json navigation.

^{Reviewed by Cursor Bugbot for commit cea95da. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
mintlify	🟢 Ready	View Preview	Apr 21, 2026, 1:54 AM