WEBINARLive webinar: Terraform in Buddy, Oct 21st.Terraform: plan, approve, apply with state in Buddy. Live on October 21st.Save your seat
Get Started on Cloud
BasicsAI AgentsPipelinesActions & ServicesEnvironmentsIntegrationsTargetsTestsDomainsSandboxesAgents & TunnelsYAMLBuddy GitCLIAPIFAQ

bdy pipeline run

View as Markdown
$bdy pipeline run [options] [command]

Start, follow and manage pipeline runs

OPTIONS
--context <name>
Connection and scope context: default, git, link or a saved name. Overrides the globally active context for this invocation.
--examples
Show only examples; with this flag --format accepts text, json or jsonl
--verbose
Show REST API requests, responses, timing and retries on stderr
-h, --help
display help for command
AVAILABLE COMMANDS
Start a pipeline run and follow its progress Required scopes: PIPELINE_RUN
Approve a pipeline run waiting for approval Required scopes: PIPELINE_RUN
Cancel a pipeline run in progress Required scopes: PIPELINE_RUN
Find runs in the recent history of a pipeline Required scopes: PIPELINE_READ
List runs of a pipeline Required scopes: PIPELINE_READ
Show the logs of a pipeline run Required scopes: PIPELINE_READ
Open this resource in a browser Required scopes: PIPELINE_READ
Resume a failed or terminated pipeline run using the API retry operation Required scopes: PIPELINE_RUN
Show the status of a pipeline run Required scopes: PIPELINE_READ

Documentation for bdy v1.25.20

Last modified on Oct 14, 2026

Next pageGetting Started

Examples

Start a run and show failed action logs after completion
bdy pip run start pipeline-identifier --failed-logs$
Return the current execution state using semantic exit codes
bdy pip run start pipeline-identifier --exit-code --no-wait$
Run pipeline with high priority and upload everything from scratch
bdy pip run start pipeline-identifier --priority HIGH -f$
Run pipeline without cache and wait for execution to complete
bdy pip run start pipeline-identifier -c$
Run pipeline and pass custom variables to execution
bdy pip run start pipeline-identifier -v key:val -v a:b$
Run pipeline and pass custom variables from file
bdy pip run start pipeline-identifier --vf path/to/env/file$
Run pipeline in given environment with specific artifact version
bdy pip run start pipeline-identifier --environment staging --artifact my_app:1.2.3$
Deploy an artifact version to an environment, wait for the result and exit 0 only when it succeeded
bdy pip run start pipeline-identifier -e production -a my_app:1.2.3 --exit-code --no-follow --failed-logs$
Run pipeline and output only final jsonl
bdy pip run start pipeline-identifier --no-follow --format jsonl$
Show run status and the last 100 lines of each failed action
bdy pip run status pipeline-identifier run-id --failed-logs$
Inspect failed actions now as JSONL with semantic exit codes
bdy pip run status pipeline-identifier run-id --failed-logs --no-wait --exit-code --format jsonl$
Check the current run state using semantic exit codes
bdy pip run status pipeline-identifier run-id --exit-code --no-wait$
Wait for completion and return its semantic exit code (run-id can come from executions[0].id of bdy pip run find)
bdy pip run status pipeline-identifier run-id --exit-code --no-follow$
Pipeline run status
bdy pip run status pipeline-identifier run-id$
Pipeline run status, get only final jsonl
bdy pip run status pipeline-identifier run-id --no-follow --format jsonl$
Return the current execution state using semantic exit codes
bdy pip run logs pipeline-identifier run-id action-run-id --exit-code --no-wait$
Pipeline run logs
bdy pip run logs pipeline-identifier run-id action-run-id$
Pipeline run logs with jsonl output
bdy pip run logs pipeline-identifier run-id action-run-id --format jsonl$
Cancel a run and show logs of actions that failed
bdy pip run cancel pipeline-identifier run-id --failed-logs$
Return the current execution state using semantic exit codes
bdy pip run cancel pipeline-identifier run-id --exit-code --no-wait$
Pipeline run cancel
bdy pip run cancel pipeline-identifier run-id$
Pipeline run cancel with final output in jsonl
bdy pip run cancel pipeline-identifier run-id --no-follow --format jsonl$
Retry a run and show failed action logs after completion
bdy pip run retry pipeline-identifier run-id --failed-logs$
Return the current execution state using semantic exit codes
bdy pip run retry pipeline-identifier run-id --exit-code --no-wait$
Pipeline run retry
bdy pip run retry pipeline-identifier run-id$
Pipeline run retry with only final JSONL output
bdy pip run retry pipeline-identifier run-id --no-follow --format jsonl$
Approve an action and show failed action logs after the run finishes
bdy pip run approve pipeline-identifier run-id action-run-id --failed-logs$
Return the current execution state using semantic exit codes
bdy pip run approve pipeline-identifier run-id action-run-id --exit-code --no-wait$
Pipeline run approve
bdy pip run approve pipeline-identifier run-id action-run-id$
Pipeline run pass params
bdy pip run approve pipeline-identifier run-id action-run-id -v a:b$
Pipeline run approve with final output in jsonl
bdy pip run approve pipeline-identifier run-id action-run-id --no-follow --format jsonl$
Pipeline run list
bdy pip run list pipeline-identifier$
Pipeline run list in json
bdy pip run list pipeline-identifier --format json$
Find failed runs, including runs without repository context
bdy pip run find my-pipeline --status FAILED$
Search the last 500 runs for an exact branch and status
bdy pip run find my-pipeline --last 500 --branch main --status FAILED$
Find pull request runs as JSON
bdy pip run find my-pipeline --pr 123 --format json$
Find the newest run for a branch; pass executions[0].id to bdy pip run status
bdy pip run find my-pipeline --branch main --format json$
Find runs for an artifact in an environment without a repository filter
bdy pip run find my-pipeline --environment staging --artifact my-app:1.2.3$