# Démarrer une tâche d'exportation statique (/fr/api/static-export/start-job)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1441 · updated: 2026-09-23 -->
Related: [Obtenir le statut d'une tâche d'exportation statique](/fr/api/static-export/get-job-status.md), [Obtenir les visiteurs uniques](/fr/api/analytics/visitors.md)

<Info>
  Ce point de terminaison est en bêta privée et nécessite un accord entreprise. Contactez [sales@mintlify.com](mailto:sales@mintlify.com) pour demander l'accès.
</Info>

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

Lance une tâche d’export statique pour un déploiement. La tâche pré-rend votre documentation sous la forme d’un ensemble autonome de fichiers HTML, RSC et ressources statiques, puis empaquette le résultat dans une seule archive téléchargeable.

Un déploiement ne peut avoir qu’une seule tâche d’export statique active à la fois. Lancer une tâche alors qu’une autre est `queued` ou `running` retourne `409`. L’endpoint est limité à 10 démarrages de tâche par organisation et par heure.

L’export statique est disponible sur les plans Enterprise.

Authentifiez-vous avec une clé d'API administrateur.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "schema": {
        "type": "string",
        "description": "L’identifiant de votre projet. Peut être copié depuis la [page des clés d'API](https://app.mintlify.com/settings/organization/api-keys) de votre Dashboard."
      },
      "required": true,
      "name": "projectId",
      "in": "path"
    }
  ],
  "responses": {
    "202": {
      "description": "La tâche d’export a été acceptée et mise en file d’attente.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "required": [
              "jobId",
              "status",
              "createdAt",
              "updatedAt"
            ],
            "properties": {
              "jobId": {
                "type": "string",
                "description": "Identifiant unique de la tâche d’export statique.",
                "example": "6520f3a1c9b1a20012ab34cd"
              },
              "status": {
                "type": "string",
                "description": "L’état actuel de la tâche.",
                "enum": [
                  "queued",
                  "running",
                  "completed",
                  "failed"
                ],
                "example": "completed"
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "description": "Date de création de la tâche."
              },
              "updatedAt": {
                "type": "string",
                "format": "date-time",
                "description": "Date du dernier changement d’état de la tâche."
              },
              "error": {
                "type": "string",
                "description": "Un message d’erreur lisible par un humain. Présent uniquement lorsque `status` est `failed`, sinon `null`.",
                "nullable": true
              },
              "bundleUrl": {
                "type": "string",
                "format": "uri",
                "description": "Un lien S3 présigné limité dans le temps vers l’archive du paquet d’export statique. Présent uniquement lorsque `status` est `completed`. Téléchargez le paquet avant `expiresAt`. Rappelez cet endpoint pour obtenir un nouveau lien.",
                "example": "https://mintlify-static-exports.s3.amazonaws.com/6520f3a1c9b1a20012ab34cd/export.zip?X-Amz-Signature=..."
              },
              "sizeBytes": {
                "type": "integer",
                "description": "La taille du paquet en octets. Présent uniquement lorsque `status` est `completed`.",
                "example": 18432000
              },
              "expiresAt": {
                "type": "string",
                "format": "date-time",
                "description": "Date d’expiration de la `bundleUrl` actuelle. Présent uniquement lorsque `status` est `completed`."
              }
            }
          }
        }
      }
    },
    "401": {
      "description": "L’authentification a échoué.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Une description de l’erreur lisible par un humain."
              }
            }
          }
        }
      }
    },
    "403": {
      "description": "L’export statique n’est pas activé pour ce déploiement. Contactez sales@mintlify.com pour effectuer une mise à niveau.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Une description de l’erreur lisible par un humain."
              }
            }
          }
        }
      }
    },
    "409": {
      "description": "Une tâche d’export statique est déjà en cours pour ce déploiement. Attendez la fin de la tâche active avant d’en lancer une nouvelle.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Une description de l’erreur lisible par un humain."
              }
            }
          }
        }
      }
    },
    "429": {
      "description": "Limite de débit dépassée. L’API d’export statique autorise jusqu’à 10 démarrages de tâche par organisation et par heure.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Une description de l’erreur lisible par un humain."
              }
            }
          }
        }
      }
    }
  }
}
```