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

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1448 · updated: 2026-09-23 -->
Related: [Obtener estado del job de exportación estática](/es/api/static-export/get-job-status.md), [Obtener visitantes únicos](/es/api/analytics/visitors.md)

<Info>
  Este endpoint está en beta privada y requiere un acuerdo empresarial. Contacta con [sales@mintlify.com](mailto:sales@mintlify.com) para solicitar acceso.
</Info>

`POST /static-export/{projectId}/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, y luego empaqueta el resultado como un único archivo descargable.

Una implementación solo puede tener un trabajo de exportación estática activo a la vez. Iniciar un trabajo mientras otro está `queued` o `running` devuelve `409`. El endpoint está limitado a 10 inicios de trabajo por organización por hora.

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

Autentícate con una clave de API de administrador.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "schema": {
        "type": "string",
        "description": "El ID de tu proyecto. Puedes copiarlo desde la página de [claves de API](https://app.mintlify.com/settings/organization/api-keys) de tu dashboard."
      },
      "required": true,
      "name": "projectId",
      "in": "path"
    }
  ],
  "responses": {
    "202": {
      "description": "El trabajo de exportación fue aceptado y puesto en cola.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "required": [
              "jobId",
              "status",
              "createdAt",
              "updatedAt"
            ],
            "properties": {
              "jobId": {
                "type": "string",
                "description": "Identificador único del trabajo de exportación estática.",
                "example": "6520f3a1c9b1a20012ab34cd"
              },
              "status": {
                "type": "string",
                "description": "El estado actual del trabajo.",
                "enum": [
                  "queued",
                  "running",
                  "completed",
                  "failed"
                ],
                "example": "completed"
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "description": "Cuándo se creó el trabajo."
              },
              "updatedAt": {
                "type": "string",
                "format": "date-time",
                "description": "Cuándo el trabajo cambió de estado por última vez."
              },
              "error": {
                "type": "string",
                "description": "Un mensaje de error legible por humanos. Solo está presente cuando `status` es `failed`; de lo contrario, es `null`.",
                "nullable": true
              },
              "bundleUrl": {
                "type": "string",
                "format": "uri",
                "description": "Un enlace de S3 prefirmado con tiempo limitado al archivo del paquete de exportación estática. Solo está presente cuando `status` es `completed`. Descarga el paquete antes de `expiresAt`. Vuelve a llamar a este endpoint para obtener un enlace nuevo.",
                "example": "https://mintlify-static-exports.s3.amazonaws.com/6520f3a1c9b1a20012ab34cd/export.zip?X-Amz-Signature=..."
              },
              "sizeBytes": {
                "type": "integer",
                "description": "El tamaño del paquete en bytes. Solo está presente cuando `status` es `completed`.",
                "example": 18432000
              },
              "expiresAt": {
                "type": "string",
                "format": "date-time",
                "description": "Cuándo caduca el `bundleUrl` actual. Solo está presente cuando `status` es `completed`."
              }
            }
          }
        }
      }
    },
    "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 implementación. Contacta con sales@mintlify.com para actualizar tu plan.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Una descripción del error legible por humanos."
              }
            }
          }
        }
      }
    },
    "409": {
      "description": "Ya hay un trabajo de exportación estática en curso para esta implementación. Espera a que el trabajo activo se complete antes de iniciar uno nuevo.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Una descripción del error legible por humanos."
              }
            }
          }
        }
      }
    },
    "429": {
      "description": "Se excedió el límite de velocidad. La API de exportación estática permite hasta 10 inicios de trabajo por organización por hora.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Una descripción del error legible por humanos."
              }
            }
          }
        }
      }
    }
  }
}
```