WEBINARLive webinar: Terraform in Buddy, Oct 21st.Terraform: plan, approve, apply with state in Buddy. Live on October 21st.Save your seat

bdy artifact version list

View as Markdown
$bdy artifact version list|ls [options] <identifier>

List versions of an artifact Required scopes: ARTIFACT_READ

ARGUMENTS
identifier
Artifact identifier (human-readable) (required)
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
-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
--page <number>
Page number (positive integer). Default: 1 (default: "1")
--per-page <number>
Items per page (positive integer). Default: 10 (default: "10")
--format <text|json>
Output format: json, text. JSON CLI errors: {error:{code,message,hint}}, exit 1. Default: text (choices: "text", "json")
--scope <scope>
Force scope (WORKSPACE, PROJECT). By default calculated by provided options and environmental variables (--project, BUDDY_PROJECT, linked project)
-h, --help
display help for command

Documentation for bdy v1.25.20

Last modified on Oct 14, 2026

Examples

List artifact versions
bdy art ver ls artifact-identifier$
List 20 artifact versions from page 2
bdy art ver ls artifact-identifier --page 2 --per-page 20$