Référence de l'API

Déploiements

Déployez, faites un rollback, vérifiez le statut et gérez les déploiements de projet.

Dernière mise à jour :

API Déploiements

Gérez les déploiements de vos projets.

Déployer / Redéployer

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

Corps de la requête (optionnel) :

{ "startOver": false }

Déclenche un nouveau déploiement. Pour les déploiements échoués, le système réessaie automatiquement depuis l'étape ayant échoué. Définissez startOver: truepour ignorer la détection de nouvelle tentative et exécuter l'intégralité du pipeline depuis le début.

Réponse :

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

Vérifier le statut de déploiement

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

Retourne la progression du déploiement en temps réel. Interrogez cet endpoint pour suivre l'état du déploiement.

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

Statuts possibles : queued, in_progress, completed, failed, cancelled

Rollback

POST /api/v1/projects/{projectId}/rollback
{ "targetDeploymentId": "deployment-uuid" }

Restaure un projet à un déploiement précédent réussi. Le déploiement cible doit avoir un statut completed.

Annuler un déploiement

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

Annule un déploiement en cours et réinitialise le projet à l'état brouillon. Ne fonctionne que lorsque le statut du projet est queued, generating, ou deploying.

Réactiver un projet

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

Réactive un projet suspendu en créant un déploiement frais à partir du dépôt de code préservé. Coûte 1 crédit.