buildx_history_inspect
Inspect a single build record by ref to retrieve duration, materials, attestations, and errors for debugging failed or slow builds. Pass the ref from buildx_history_list; optionally specify a builder.
Instructions
Inspect a single build record by ref, parsed from --format json.
Returns the full record for one build — duration, materials, attestations, error (if any) —
for debugging a failed or slow build found via buildx_history_list. Requires buildx >=
v0.13.
Raises RuntimeError if the CLI call fails.
args:
ref - Build record ref. Pass the ref field from buildx_history_list directly — it
reports a qualified "//", but history inspect only accepts the
bare id, so this reduces it to the id and (unless builder is given) targets the
builder named in the ref. Empty/omitted inspects the most recent build; the ^N
syntax (e.g. "^0" = latest) is also valid.
builder - Builder instance the build ran on (defaults to the one in ref, else active)
returns: dict - The parsed build record (or {"raw": } if the output isn't a JSON object)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | ||
| builder | No |