API 레퍼런스

배포

배포, 롤백, 상태 확인 및 프로젝트 배포 관리.

마지막 업데이트: 2026년 5월 28일

배포 API

프로젝트의 배포를 관리합니다.

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

요청 본문 (선택 사항):

{ "startOver": false }

새 배포를 트리거합니다. 실패한 배포의 경우, 시스템은 자동으로 실패한 단계부터 재시도합니다. 재시도 감지를 건너뛰고 처음부터 전체 파이프라인을 실행하려면 startOver: true를 설정하십시오.

응답:

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

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

실시간 배포 진행 상황을 반환합니다. 이 엔드포인트를 폴링하여 배포 상태를 추적합니다.

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

가능한 상태: queued, in_progress, completed, failed, cancelled

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

{ "targetDeploymentId": "deployment-uuid" }

프로젝트를 이전의 성공적인 배포 상태로 되돌립니다. 대상 배포의 상태는completed여야 합니다.

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

진행 중인 배포를 취소하고 프로젝트를 초안 상태로 재설정합니다. 프로젝트 상태가 queued, generating, 또는 deploying일 때만 작동합니다.

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

보존된 코드 저장소에서 새 배포를 생성하여 일시 중단된 프로젝트를 재활성화합니다. 크레딧 1개를 소모합니다.