Skip to main content
GET
/
v1
/
templates
/
{id}
/
builds
List build history for a template
import requests

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

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

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

print(response.text)
{
  "builds": [
    {
      "build_id": "<string>",
      "template_id": "<string>",
      "name": "<string>",
      "tags": [
        "<string>"
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "source_digest": "<string>",
      "context_digest": "<string>",
      "dockerfile_digest": "<string>",
      "triggered_by": "<string>",
      "queued_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "finished_at": "2023-11-07T05:31:56Z",
      "duration_ms": 123,
      "failure_phase": "<string>",
      "cache_summary": {
        "final_artifact_hits": 123,
        "final_artifact_misses": 123,
        "final_artifact_bypasses": 123,
        "final_artifact_stores": 123,
        "layer_hits": 123,
        "layer_misses": 123,
        "layer_bypasses": 123,
        "layer_stores": 123,
        "file_blob_hits": 123,
        "file_blob_misses": 123,
        "file_blob_bypasses": 123,
        "file_blob_stores": 123
      },
      "artifact_availability": {
        "reason": "<string>"
      },
      "promotability": {
        "promotable": true,
        "reason": "<string>"
      },
      "retention_expires_at": "2023-11-07T05:31:56Z",
      "artifact_ids": [
        "<string>"
      ]
    }
  ],
  "next_cursor": "<string>"
}

Authorizations

Authorization
string
header
required

API key passed as Bearer token

Path Parameters

id
string
required

Template artifact ID or legacy unnamespaced template ref

Query Parameters

status
enum<string>
Available options:
waiting,
building,
ready,
error,
cancelled
backend
enum<string>

Template build backend. native is retained for declarative/OCI build requests and historical filters; Dockerfile build requests use buildkit.

Available options:
native,
buildkit
source_type
enum<string>
Available options:
declarative,
dockerfile,
oci_import,
template_base
limit
integer
Required range: 1 <= x <= 100
cursor
string

Response

Build history page

builds
object[]
required
next_cursor
string