Deployments API

Trigger Deployment

POST /v1/services/:serviceId/deployments

Response:

{
  "id": "uuid",
  "serviceId": "uuid",
  "status": "building",
  "triggeredBy": "manual",
  "createdAt": "2026-03-28T00:00:00Z"
}

List Deployments

GET /v1/services/:serviceId/deployments?page=1&limit=20

Get Deployment

GET /v1/services/:serviceId/deployments/:deploymentId

Get Build Logs

GET /v1/services/:serviceId/deployments/:deploymentId/logs

Returns build/deployment logs as sanitized text.

Deployment Statuses

Status	Description
queued	Waiting to build
building	Build in progress
deploying	Build complete, deploying container
running	Successfully deployed and live
failed	Build or deployment failed
cancelled	Cancelled by user