Skip to main content
GET
/
v1
/
templates
/
builds
/
{build_id}
Poll template build status and incremental events
import requests

url = "https://api.13-215-85-171.sslip.io/v1/templates/builds/{build_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
{
  "build": {
    "build_id": "tb_123",
    "template_id": "tmpl_123",
    "name": "python-dev",
    "tags": [
      "default"
    ],
    "status": "error",
    "build_backend": "buildkit",
    "source_type": "dockerfile",
    "error": "build step 2 failed",
    "error_detail": {
      "code": "build_error",
      "message": "build step 2 failed",
      "phase": "build_step",
      "retryable": false,
      "suggested_action": "Inspect the build logs and fix the failing step.",
      "build_id": "tb_123",
      "request_id": "req_123",
      "step_index": 2,
      "details": {
        "reason": "build_step_nonzero_exit"
      }
    },
    "canonical_ref": "acme/python-dev",
    "namespace_slug": "acme",
    "visibility": "private",
    "created_at": "2026-03-17T00:00:00Z",
    "updated_at": "2026-03-17T00:00:12Z"
  },
  "entries": [
    {
      "build_id": "tb_123",
      "template_id": "tmpl_123",
      "offset": 10,
      "timestamp": "2026-03-17T00:00:12Z",
      "kind": "error",
      "level": "error",
      "message": "build step 2 failed",
      "error_detail": {
        "code": "build_error",
        "message": "build step 2 failed",
        "phase": "build_step",
        "retryable": false,
        "suggested_action": "Inspect the build logs and fix the failing step.",
        "build_id": "tb_123",
        "request_id": "req_123",
        "step_index": 2,
        "details": {
          "reason": "build_step_nonzero_exit"
        }
      }
    }
  ],
  "next_offset": 11
}

Authorizations

Authorization
string
header
required

API key passed as Bearer token

Path Parameters

build_id
string
required

Query Parameters

offset
integer<uint64>

Response

Current build state with incremental events

build
object
required
entries
object[]
required
next_offset
integer<uint64>
required