# Start static export job (/api/static-export/start-job)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1355 · updated: 2026-09-23 -->
Related: [Get static export job status](/api/static-export/get-job-status.md), [Get unique visitors](/api/analytics/visitors.md)

<Info>
  This endpoint is in private beta and requires an enterprise agreement. Contact [sales@mintlify.com](mailto:sales@mintlify.com) to request access.
</Info>

`POST /static-export/{projectId}/jobs`

Start a static export job for a deployment. The job pre-renders your documentation into a self-contained set of static HTML, RSC, and asset files, then packages the result as a single downloadable archive.

A deployment can have only one active static export job at a time. Starting a job while another is `queued` or `running` returns `409`. Rate-limited to 10 job starts per organization per hour.

Static export is available on Enterprise plans.

Authenticate with an admin API key.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "schema": {
        "type": "string",
        "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,
      "name": "projectId",
      "in": "path"
    }
  ],
  "responses": {
    "202": {
      "description": "The export job was accepted and queued.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "required": [
              "jobId",
              "status",
              "createdAt",
              "updatedAt"
            ],
            "properties": {
              "jobId": {
                "type": "string",
                "description": "Unique identifier for the static export job.",
                "example": "6520f3a1c9b1a20012ab34cd"
              },
              "status": {
                "type": "string",
                "description": "The current state of the job.",
                "enum": [
                  "queued",
                  "running",
                  "completed",
                  "failed"
                ],
                "example": "completed"
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "description": "When the job was created."
              },
              "updatedAt": {
                "type": "string",
                "format": "date-time",
                "description": "When the job last transitioned state."
              },
              "error": {
                "type": "string",
                "description": "A human-readable error message. Present only when `status` is `failed`, otherwise `null`.",
                "nullable": true
              },
              "bundleUrl": {
                "type": "string",
                "format": "uri",
                "description": "A time-limited presigned S3 link to the static export bundle archive. Present only when `status` is `completed`. Download the bundle before `expiresAt`. Call this endpoint again to get a fresh link.",
                "example": "https://mintlify-static-export-outputs-prod.s3.amazonaws.com/6520f3a1c9b1a20012ab34cd/export.zip?X-Amz-Signature=..."
              },
              "sizeBytes": {
                "type": "integer",
                "description": "The size of the bundle in bytes. Present only when `status` is `completed`.",
                "example": 18432000
              },
              "expiresAt": {
                "type": "string",
                "format": "date-time",
                "description": "When the current `bundleUrl` expires. Present only when `status` is `completed`."
              }
            }
          }
        }
      }
    },
    "401": {
      "description": "Authentication failed.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "A human-readable description of the error."
              }
            }
          }
        }
      }
    },
    "403": {
      "description": "Static export is not enabled for this deployment. Contact sales@mintlify.com to upgrade.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "A human-readable description of the error."
              }
            }
          }
        }
      }
    },
    "409": {
      "description": "A static export job is already in progress for this deployment. Wait for the active job to complete before starting a new one.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "A human-readable description of the error."
              }
            }
          }
        }
      }
    },
    "429": {
      "description": "Rate limit exceeded. The static export API allows up to 10 job starts per organization per hour.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "A human-readable description of the error."
              }
            }
          }
        }
      }
    }
  }
}
```