ZevCloud
Dashboard

API Reference

Deployments API

Trigger Deployment

POST /v1/services/:serviceId/deployments

Response:

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

Roll Back

POST /v1/services/:serviceId/deployments

Send the commit to roll back to:

{
  "commitSha": "a1b2c3d..."
}

If a build of that commit is still stored, the rollback is instant and nothing is rebuilt. If it isn’t, services built with a Dockerfile rebuild that commit, and other services return an error: push a revert commit to the branch instead.

List Rollback Targets

GET /v1/services/:serviceId/deployments/rollback-targets

Returns the commits this service can roll back to instantly, and the commit currently deployed.

{
  "commits": ["9f3c2a1e7b...", "4d81b0c5aa..."],
  "current": "9f3c2a1e7b..."
}

commits lists commit SHAs. current is null when it can’t be determined. A commit missing from the list can still be rolled back on a Dockerfile service, by rebuilding it.

Cancel Deployment

POST /v1/services/:serviceId/deployments/:deploymentId/cancel

Cancels a queued or running deployment. The service keeps serving its previous version.

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

StatusDescription
queuedWaiting to build
buildingBuild in progress
deployingBuild complete, deploying container
runningSuccessfully deployed and live
failedBuild or deployment failed
cancelledCancelled by user

Updated at, Monday, October 26, 2026