bk build list and view support --summary metadata-only output
Introduced 2026-07-15 · score 0.98
HOW TO USE IT
When checking build state in polling or automation, pass `--summary` to `bk build list` or `bk build view` to request metadata-only output.
bk build list --summary --jsonbk build view <build-number> --summary --yamlWHY THIS HELPS
Check build state in a polling loop or automation without requesting unused build payloads.
BEFORE THIS CHANGE
Build state checks downloaded jobs, expanded pipeline details, artifacts, and annotations, even when polling automation did not use them.
REQUIREMENTS AND LIMITATIONS
- Version: v3.52.0
- --summary: Return metadata only for fast state checks and polling; opt-in.
- --json / --yaml: Select JSON or YAML output format.
- <build-number>: Build number to view; omit to view the most recent build.
- Prerequisite: CLI configured with a Buildkite API access token; the Builds API requires the `read_builds` scope. The docs do not state a minimum CLI version for `--summary`.
- Prerequisite: The `read_builds` scope is required to list builds.
- `--summary` is opt-in.
- Organization and pipeline slugs appear only when known.
FIRST-PARTY EVIDENCE
- https://github.com/buildkite/cli/releases/tag/v3.52.0
- https://github.com/buildkite/cli/pull/911
- https://buildkite.com/docs/platform/cli/reference/build
- https://buildkite.com/docs/platform/cli/configuration
- https://buildkite.com/docs/apis/rest-api/builds
Check the installed version and the source before using it. Entry JSON