# Trigger deployment (/api/update/trigger)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 268 · updated: 2026-07-30 -->
Related: [Get deployment status](/api/update/status.md), [Trigger preview deployment](/api/preview/trigger.md)



`POST /project/update/{projectId}`

Queue a deployment update for your documentation project. Returns a status ID that can be used to track the update progress. The update is triggered from your configured deployment branch.

Authenticate with an admin API key.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "name": "projectId",
      "in": "path",
      "description": "Your project ID. Can be copied from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page in your dashboard.",
      "required": true,
      "schema": {
        "type": "string"
      }
    }
  ],
  "responses": {
    "202": {
      "description": "A successful response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "statusId": {
                "type": "string",
                "description": "The status ID of the triggered updated."
              }
            }
          }
        }
      }
    }
  }
}
```