API
Builds API
List, start, read and cancel builds.
List Builds
GET /api/v1/teams/{teamSlug}/projects/{projectSlug}/buildsResponse 200:
[
{
"id": "uuid",
"project_id": "uuid",
"team_id": "uuid",
"trigger_type": "webhook",
"git_commit_sha": "abc123...",
"git_commit_msg": "fix: update deps",
"git_branch": "main",
"git_author": "John Doe <john@example.com>",
"build_number": 42,
"build_method": "buildpack",
"image_tag": "registry.clusterz.eu/my-team/my-app:build-42",
"status": "succeeded",
"started_at": "2025-01-15T10:00:00Z",
"finished_at": "2025-01-15T10:03:45Z",
"duration_ms": 225000,
"created_at": "2025-01-15T10:00:00Z"
}
]Build statuses: queued, cloning, building, pushing, succeeded, failed, cancelled
Trigger Build
POST /api/v1/teams/{teamSlug}/projects/{projectSlug}/builds
Content-Type: application/jsonRequest Body (optional):
{
"branch": "feature-branch"
}Response 201: Build object with status queued
Get Build
GET /api/v1/teams/{teamSlug}/projects/{projectSlug}/builds/{buildId}Response 200: Build object
Cancel Build
DELETE /api/v1/teams/{teamSlug}/projects/{projectSlug}/builds/{buildId}Response 200: Build object with status cancelled