Deployments

All endpoints require Authorization: Bearer TOKEN.

Create Deployment

Upload a tar.gz archive of your source code to trigger a build and deploy.


POST /api/v1/deployments
Content-Type: multipart/form-data

Form fields:

Field	Type	Description
`project_id`	`string`	Project ID
`file`	`file`	Source code as `.tar.gz`

Response: 201


{
  "id": "dpl_abc123",
  "project_id": "prj_abc123",
  "status": "building",
  "created_at": "2025-01-15T10:30:00Z"
}

Deployment statuses: building → deploying → running / failed


GET /api/v1/deployments/project/:projectId


GET /api/v1/deployments/:id

Roll back to a specific deployment.


POST /api/v1/deployments/:id/rollback

Response: 200


{
  "message": "Rollback initiated",
  "deployment_id": "dpl_abc123"
}