bk build step-uploads lists dynamic step upload outcomes
Introduced 2026-10-20 · score 0.97
HOW TO USE IT
When investigating dynamic pipeline upload outcomes for a Buildkite build, run `bk build step-uploads` with its build number, qualified selector, or URL. Inspect each upload’s state, source job, created job count, and rejection or outcome message; for more diagnostics, check the source job’s pipeline upload command output.
bk build step-uploads 123 --pipeline my-pipeline --jsonbk build step-uploads acme/my-pipeline/123 --textbk build step-uploads https://buildkite.com/acme/my-pipeline/builds/123 --yamlWHY THIS HELPS
Investigate dynamic pipeline upload outcomes for a Buildkite build.
BEFORE THIS CHANGE
Use raw API requests to inspect dynamic pipeline upload failures.
REQUIREMENTS AND LIMITATIONS
- Version: v3.64.2
- build number (positional) (required): Build number, org/pipeline/number selector, or Buildkite build URL.
- --pipeline: Pipeline slug or org/pipeline; inferred from configuration or repository if omitted. Specify when inference is ambiguous, since JSON/YAML does not prompt.
- --json: Select JSON output format.
- --text: Select text output format.
- --yaml: Select YAML output format.
- Prerequisite: The token requires the `read_builds` scope.
- Prerequisite: Install the CLI and authenticate with `bk auth login` before use.
- Requires the `read_builds` token scope.
- JSON/YAML never prompts for pipeline selection; specify `--pipeline` when inference is ambiguous.
- All cursor pages are fetched, newest first.
- Uploaded definitions are not fetched.
- Rejection and failure messages exclude uploaded configuration and internal failure details.
- The API retains uploads only within the build's maximum lifetime, up to 30 days after creation; older builds return a `410 Gone` error rather than an empty result.
- Other API errors fail the command without partial results.
FIRST-PARTY EVIDENCE
- https://github.com/buildkite/cli/releases/tag/v3.64.2
- https://github.com/buildkite/cli/pull/1050
- https://raw.githubusercontent.com/buildkite/cli/v3.64.2/README.md
- https://raw.githubusercontent.com/buildkite/cli/v3.64.2/cmd/build/step_uploads.go
Check the installed version and the source before using it. Entry JSON