Referensi API

Deployments

Trigger a deploy and poll build status over the API.

Terakhir diperbarui:

Deployment API

Manage deployments for your projects.

Deploy / Redeploy

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

Request Body (optional):

{ "startOver": false }

Triggers a new deployment. For failed deployments, the system automatically retries from the failed step. Set startOver: true to skip retry detection and run the full pipeline from scratch.

Response:

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

Check Deployment Status

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

Returns real-time deployment progress. Poll this endpoint to track deployment status. Once the deployment completes, the project is live at its cryptohopper.app URL.

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

Possible statuses: queued, in_progress, completed, failed, cancelled

Cancel Deployment

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

Cancels an in-progress deployment and resets the project to draft status. Only works when the project status is queued, generating, or deploying.

Errors

A deploy while one is already running returns 409 CONFLICT — wait for the current deployment to finish or cancel it first. Deploys also consume credits and are rate limited; see Error Handling for the full reference.