API

WebSocket API

Follow build logs and deployment changes live.

GET /api/v1/ws

Requires authentication. Upgrades to WebSocket connection.

Client Messages

Subscribe to a channel:

{ "action": "subscribe", "channel": "build:<build-id>:logs" }

Unsubscribe:

{ "action": "unsubscribe", "channel": "build:<build-id>:logs" }

Log line:

{
  "type": "log",
  "channel": "build:<build-id>:logs",
  "data": { "build_id": "uuid", "line": "Installing dependencies...", "timestamp": "..." }
}

Status update:

{
  "type": "status",
  "channel": "build:<build-id>:logs",
  "data": { "build_id": "uuid", "status": "building" }
}

Channel Pattern	Events
`build:<id>:logs`	Build log lines, status changes
`deployments`	Deployment status updates

Platform admin API

The staff routes that set prices and plans.

Webhooks

The push hooks Clusterz receives from GitHub, GitLab and Bitbucket.