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

View as Markdown
$bdy pipeline|pip [options] [command]

Manage pipelines and their 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
Create a pipeline from a YAML definition Required scopes: PIPELINE_WRITE
Delete a pipeline Required scopes: PIPELINE_MANAGE
Show pipeline details Required scopes: PIPELINE_READ
List pipelines in a project Required scopes: PIPELINE_READ
Open this resource in a browser Required scopes: PIPELINE_READ
Start, follow and manage pipeline runs
Update a pipeline from a YAML definition Required scopes: PIPELINE_WRITE
Print a pipeline definition as YAML 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$
Pipeline list
bdy pip list$
Pipeline list in json
bdy pip list --format json$
Pipeline get
bdy pip get pipeline-identifier$
Pipeline get in json
bdy pip get pipeline-identifier --format json$
Pipeline delete
bdy pip rm pipeline-identifier$
Pipeline force delete
bdy pip rm pipeline-identifier -f$
Pipeline yml
bdy pip yml pipeline-identifier$
Pipeline create with name
bdy pip create -n name$
Pipeline create with yaml
bdy pip create --yaml @path/to/yaml$
Pipeline create with name, output json
bdy pip create -n name --format json$
Pipeline update with yaml
bdy pip update pipeline-identifier @path/to/yaml$
Pipeline update with yaml and output json
bdy pip update pipeline-identifier @path/to/yaml --format json$