# Iniciar job de exportación estática (/es/api/static-export/start-job)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1426 · updated: 2026-07-30 -->
Related: [Obtener estado del job de exportación estática](/es/api/static-export/get-job-status.md), [Generar paquete de exportación](/es/api/static-export/generate-bundle.md), [Obtener estadísticas de llamadas del assistant](/es/api/analytics/assistant-caller-stats.md)

<Info>
  La exportación estática requiere un [plan Enterprise](https://mintlify.com/pricing?ref=static-export).
</Info>

`POST /static-export/jobs`

Inicia un trabajo de exportación estática para una implementación. El trabajo prerrenderiza tu documentación en un conjunto autocontenido de archivos HTML, RSC y recursos estáticos. Devuelve un ID de trabajo que puedes usar para consultar el estado y, una vez completado, generar un paquete descargable.

La exportación estática está disponible en los planes Enterprise.

Autentícate con una clave de API de administrador.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "domain"
          ],
          "properties": {
            "domain": {
              "type": "string",
              "description": "El dominio principal de la implementación que se va a exportar. Usa el dominio personalizado configurado para tu proyecto en el dashboard de Mintlify (por ejemplo, `docs.example.com`). Si no has configurado un dominio personalizado, usa tu subdominio de Mintlify (por ejemplo, `acme.mintlify.app`). Proporciona solo el nombre de host: no incluyas el protocolo, una barra final ni un prefijo de ruta como `/docs`.",
              "example": "docs.example.com"
            },
            "version": {
              "type": "string",
              "description": "Una etiqueta de versión opcional para identificar esta exportación. Por defecto, se usa la última versión publicada.",
              "example": "2024-06-01"
            },
            "paths": {
              "type": "array",
              "description": "Una lista opcional de rutas de página que se incluirán. Si se omite, se exportan todas las páginas publicadas.",
              "items": {
                "type": "string"
              },
              "example": [
                "index",
                "guides/getting-started",
                "api-reference/introduction"
              ]
            }
          }
        }
      }
    }
  },
  "responses": {
    "202": {
      "description": "El trabajo de exportación fue aceptado y puesto en cola.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "required": [
              "jobId",
              "status",
              "progress",
              "pageCount",
              "createdAt",
              "updatedAt"
            ],
            "properties": {
              "jobId": {
                "type": "string",
                "description": "Identificador único del trabajo de exportación estática.",
                "example": "se_3f9a2c1b8e7d4a06"
              },
              "status": {
                "type": "string",
                "description": "El estado actual del trabajo.",
                "enum": [
                  "queued",
                  "running",
                  "completed",
                  "failed"
                ],
                "example": "running"
              },
              "progress": {
                "type": "number",
                "description": "Porcentaje de finalización de 0 a 100.",
                "minimum": 0,
                "maximum": 100,
                "example": 42
              },
              "pageCount": {
                "type": "integer",
                "description": "El número de páginas exportadas hasta el momento.",
                "example": 128
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "description": "Cuándo se creó el trabajo."
              },
              "updatedAt": {
                "type": "string",
                "format": "date-time",
                "description": "Cuándo se actualizó por última vez el trabajo."
              },
              "error": {
                "type": "string",
                "description": "Un mensaje de error legible por humanos. Solo está presente cuando `status` es `failed`.",
                "nullable": true
              }
            }
          }
        }
      }
    },
    "400": {
      "description": "El cuerpo de la solicitud no es válido. Verifica que `domain` sea un nombre de host accesible y que las entradas de `paths` sean rutas de página válidas.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Una descripción del error legible por humanos."
              }
            }
          }
        }
      }
    },
    "401": {
      "description": "La autenticación falló.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Una descripción del error legible por humanos."
              }
            }
          }
        }
      }
    },
    "403": {
      "description": "La exportación estática no está habilitada para esta organización. Contacta con el equipo de ventas para habilitarla en un plan Enterprise.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Una descripción del error legible por humanos."
              }
            }
          }
        }
      }
    }
  }
}
```