Sign in

v33

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-175267122.5 KB

Create a new build

Creates a new build job. Source code should be uploaded as a tar.gz archive in the multipart form data.

post/builds

Response

Build created and queued

idstring required

Build job identifier

status'queued' | 'building' | 'pushing' | 'ready' | 'failed' | 'cancelled' required

Build job status

tagsTags

User-defined key-value tags.

queue_positioninteger nullable

Position in build queue (only when status is queued)

image_digeststring nullable

Digest of built image (only when status is ready)

image_refstring nullable

Full image reference (only when status is ready)

errorstring nullable

Error message (only when status is failed)

created_atstring date-time required

Build creation timestamp

started_atstring date-time nullable

Build start timestamp

completed_atstring date-time nullable

Build completion timestamp

duration_msinteger nullable

Build duration in milliseconds

builder_instance_idstring nullable

Instance ID of the builder VM (for debugging)

Example response

{
  "id": "build-abc123",
  "tags": {
    "team": "backend",
    "env": "staging"
  }
}