Despliegues

API de implementaciones

Gestiona las implementaciones de tus proyectos.

Implementar / Reimplementar

POST /api/v1/projects/{projectId}/deploy

Cuerpo de la solicitud (opcional):

{ "startOver": false }

Inicia una nueva implementación. Para implementaciones fallidas, el sistema reintenta automáticamente desde el paso fallido. Establece startOver: true para omitir la detección de reintentos y ejecutar el pipeline completo desde cero.

Respuesta:

{
  "data": {
    "id": "deployment-uuid",
    "version": 3,
    "status": "queued",
    "isRetry": false,
    "queuePriority": 2
  }
}

Verificar estado de implementación

GET /api/v1/projects/{projectId}/status

Devuelve el progreso de implementación en tiempo real. Consulta este endpoint para rastrear el estado de la implementación.

{
  "data": {
    "step": 3,
    "totalSteps": 6,
    "status": "in_progress",
    "message": "Building your app...",
    "progress": 50
  }
}

Estados posibles: queued, in_progress, completed, failed, cancelled

Rollback

POST /api/v1/projects/{projectId}/rollback

{ "targetDeploymentId": "deployment-uuid" }

Revierte un proyecto a una implementación exitosa anterior. La implementación de destino debe tener el estado completed.

Cancelar implementación

POST /api/v1/projects/{projectId}/cancel

Cancela una implementación en curso y restablece el proyecto al estado borrador. Solo funciona cuando el estado del proyecto es queued, generating, o deploying.

Reactivar proyecto

POST /api/v1/projects/{projectId}/reactivate

Reactiva un proyecto suspendido creando una nueva implementación desde el repositorio de código conservado. Cuesta 1 crédito.