> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrer une tâche d'exportation statique

> 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. Retourne un identifiant de tâche que vous pouvez utiliser pour interroger le statut et, une fois la tâche terminée, générer un paquet téléchargeable.

L’export statique est disponible sur les plans Enterprise.

<Info>
  L'exportation statique nécessite un [forfait Enterprise](https://mintlify.com/pricing?ref=static-export).
</Info>


## OpenAPI

````yaml fr/static-export-openapi.json POST /static-export/jobs
openapi: 3.0.1
info:
  title: API d’export statique Mintlify
  description: >-
    Générez par programmation un export statique autonome de votre documentation
    et téléchargez-le sous forme d’un seul paquet. Disponible sur les plans
    Enterprise.
  version: 1.0.0
servers:
  - url: https://api.mintlify.com/v1
security:
  - bearerAuth: []
paths:
  /static-export/jobs:
    post:
      summary: Lancer une tâche d’export statique
      description: >-
        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. Retourne un identifiant de tâche que
        vous pouvez utiliser pour interroger le statut et, une fois la tâche
        terminée, générer un paquet téléchargeable.


        L’export statique est disponible sur les plans Enterprise.
      operationId: startStaticExportJob
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartStaticExportRequest'
      responses:
        '202':
          description: La tâche d’export a été acceptée et mise en file d’attente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticExportJob'
        '400':
          description: >-
            Le corps de la requête n’est pas valide. Vérifiez que `domain` est
            un nom d’hôte accessible et que les entrées de `paths` sont des
            chemins de page valides.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: L’authentification a échoué.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: >-
            L’export statique n’est pas activé pour cette organisation.
            Contactez le service commercial pour l’activer sur un plan
            Enterprise.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    StartStaticExportRequest:
      type: object
      required:
        - domain
      properties:
        domain:
          type: string
          description: >-
            Le domaine du déploiement à exporter, par exemple
            `docs.example.com`.
          example: docs.example.com
        version:
          type: string
          description: >-
            Un libellé de version facultatif pour identifier cet export. Par
            défaut, il s’agit de la dernière version publiée.
          example: '2024-06-01'
        paths:
          type: array
          description: >-
            Une liste facultative de chemins de page à inclure. Si elle est
            omise, toutes les pages publiées sont exportées.
          items:
            type: string
          example:
            - index
            - guides/getting-started
            - api-reference/introduction
    StaticExportJob:
      type: object
      required:
        - jobId
        - status
        - progress
        - pageCount
        - createdAt
        - updatedAt
      properties:
        jobId:
          type: string
          description: Identifiant unique de la tâche d’export statique.
          example: se_3f9a2c1b8e7d4a06
        status:
          type: string
          description: L’état actuel de la tâche.
          enum:
            - queued
            - running
            - completed
            - failed
          example: running
        progress:
          type: number
          description: Pourcentage d’avancement de 0 à 100.
          minimum: 0
          maximum: 100
          example: 42
        pageCount:
          type: integer
          description: Le nombre de pages exportées jusqu’à présent.
          example: 128
        createdAt:
          type: string
          format: date-time
          description: Date de création de la tâche.
        updatedAt:
          type: string
          format: date-time
          description: Date de la dernière mise à jour de la tâche.
        error:
          type: string
          description: >-
            Un message d’erreur lisible par un humain. Présent uniquement
            lorsque `status` est `failed`.
          nullable: true
    Error:
      type: object
      properties:
        error:
          type: string
          description: Une description de l’erreur lisible par un humain.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Clé d’API administrateur. Générez-en une sur la page des clés d’API de
        votre Dashboard.

````

## Related topics

- [Obtenir le statut d'une tâche d'exportation statique](/docs/fr/api/static-export/get-job-status.md)
- [Exportation statique](/docs/fr/api/static-export/overview.md)
- [Générer le bundle d'exportation](/docs/fr/api/static-export/generate-bundle.md)