bdy artifact download

$bdy artifact download|dd [options] <identifier> <directory>

Download file artifact. Required scopes: ARTIFACT_READ

ARGUMENTS

identifier

Human-readable ID of the artifact and optionally version: artifact@version (optional)

directory

Path to the directory or file (required)

OPTIONS

-w, --workspace <domain>

Workspace URL handle. Can be set via variable: BUDDY_WORKSPACE

-p, --project <name>

Project name. Can be set via variable: BUDDY_PROJECT

-m, --merge

Merge contents of the directory with artifact

-r, --replace

Replace contents of the directory with artifact

-h, --help

display help for command

Documentation for bdy v1.20.0

Last modified on Apr 13, 2026

Examples

Download file artifact version to local directory
bdy art dd artifact-identifier@version /path/to/dir$

Download latest file artifact version and replace contents of existing local directory
bdy art dd artifact-identifier /path/to/dir --replace$

Download file artifact version and merge it with existing local directory
bdy art dd artifact-identifier@version /path/to/dir --merge$