bk pipeline copy adds cp and cross-organization copying
Introduced 2026-01-05 · score 0.98
HOW TO USE IT
When copying a pipeline within or across organizations, use `bk pipeline cp`; omit the source to select it interactively or pass its slug or `org/slug`. Set `--target` to the new pipeline name or `org/name`; for a cross-organization copy into an organization using clusters, provide `--cluster` with the target cluster ID.
bk pipeline cp <source-pipeline> --target <new-pipeline>bk pipeline cp <source-org>/<source-pipeline> --target <target-org>/<new-pipeline> --cluster <target-cluster-id>bk pipeline cp <source-pipeline> --target <new-pipeline> --dry-runWHY THIS HELPS
Copy a pipeline within an organization or across configured organizations.
REQUIREMENTS AND LIMITATIONS
- Version: v3.17.0
- <pipeline>: Source pipeline slug or org/slug; omitted source is resolved from current context or prompted for.
- --target, -t <target>: New pipeline name or org/name. If omitted, prompts for a target.
- --cluster, -c <cluster>: Target cluster name or ID; required for cross-organization copies if the target organization uses clusters.
- --dry-run: Show what would be copied without creating the pipeline.
- --output, -o <format>: Output format: json, yaml, or text.
- Prerequisite: Configure the CLI with an API access token and organization. Configure an individual token for each organization you need to use.
- Prerequisite: The v3.17.0 command prompts for a target cluster ID on a cross-organization copy if `--cluster` is omitted; the cluster may be required when the target organization uses clusters.
- Cross-organization copying applies when the organizations are configured.
- Docs conflict: Current CLI reference documents `--cluster-name` and `--cluster-uuid`; v3.17.0 source documents `--cluster` instead. Use the versioned v3.17.0 flag for this card: https://buildkite.com/docs/platform/cli/reference/pipeline
FIRST-PARTY EVIDENCE
- https://github.com/buildkite/cli/releases/tag/v3.17.0
- https://github.com/buildkite/cli/pull/600
- https://raw.githubusercontent.com/buildkite/cli/v3.17.0/cmd/pipeline/copy.go
- https://buildkite.com/docs/platform/cli/configuration
Check the installed version and the source before using it. Entry JSON