Programming — entry 004 of 4
Mintlify
Mintlify's Admin API lets a documentation project's own backend trigger deployments, kick off AI agent jobs, and pull analytics (page views, search queries, feedback) via bearer-token endpoints prefixed mint_, confirmed live by a real request that returned a clean 401 "Unauthorized" rather than any generic error, with a separate CORS preflight also succeeding. Admin API access itself is gated to Mintlify's paid Pro plan and above — the free Starter tier covers hosting and the docs editor but not the Admin API — per its own current pricing page.
GreatAPIs Score
Embed this badge
<a href="https://greatapis.com/api/mintlify/"><img src="https://greatapis.com/badge/mintlify.svg" alt="Scored 81 on greatapis.com"></a>Auth quickstart
- Get a key at the provider
- Send it on every request as a header
Authorization: Bearer <key>
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
project3
POST/project/preview/{projectId}Trigger preview deployment
| Name | In | Required | Type |
|---|---|---|---|
projectId | path | yes | string |
application/json (required)
| Status | Description | Schema |
|---|---|---|
202 | Preview deployment queued successfully. | — |
400 | Invalid request. The `branch` field is required. | — |
403 | Preview deployments are not available on your current plan. | — |
GET/project/update-status/{statusId}Get update status
| Name | In | Required | Type |
|---|---|---|---|
statusId | path | yes | string |
| Status | Description | Schema |
|---|---|---|
200 | A successful response | — |
POST/project/update/{projectId}Trigger update
| Name | In | Required | Type |
|---|---|---|---|
projectId | path | yes | string |
| Status | Description | Schema |
|---|---|---|
202 | A successful response | — |
workflow1
POST/workflow/{projectId}/{workflowSchemaId}/triggerTrigger automation
| Name | In | Required | Type |
|---|---|---|---|
projectId | path | yes | string |
workflowSchemaId | path | yes | string |
| Status | Description | Schema |
|---|---|---|
202 | Automation run queued successfully. | — |
400 | Invalid request. The automation ID is malformed, the automation is not active, or the automation is not configured with a custom schedule. | — |
404 | The automation was not found or does not belong to this project. | — |
Try it
Developer reference
https://api.mintlify.com/v110 requests/second and 1,000 requests/day per IP on the public Mintlify Index MCP server (429 on excess); separately, up to 10 API keys/hour per organization on the Admin REST API
- POST/project/update/{projectId}
- GET/project/update-status/{statusId}
- POST/project/preview/{projectId}