bdy artifact create

$bdy artifact create|add [options] [name]

Create an artifact Required scopes: ARTIFACT_WRITE

ARGUMENTS

name

Artifact name (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

-i, --identifier <identifier>

Artifact identifier (auto-generated from name if omitted)

-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

-t, --type <type>

Artifact type: "BUCKET" or "CONTAINER" (default: "BUCKET")

--scope <scope>

Force scope (WORKSPACE, PROJECT). By default calculated by provided options and environmental variables (--project, BUDDY_PROJECT, linked project)

-b, --buddy

Enforce HTTP Buddy authorization

-a, --auth <user:pass>

Enforce HTTP basic authorization

--note <note>

Resource note

--agent-note <note>

Note for AI agents operating on this resource; stored as agent_note and meant to be read before acting on the resource

--format <text|json>

Output format: json, text. JSON CLI errors: {error:{code,message,hint}}, exit 1. Default: text (choices: "text", "json")

-h, --help

display help for command

Documentation for bdy v1.25.20

Last modified on Oct 14, 2026

Examples

Create file artifact with name
bdy art create test$

Create file artifact with buddy authorization and identifier
bdy art create test -b -i artifact-identifier$

Create file artifact with basic authorization
bdy art create -a user:pass$

Create docker containers artifact
bdy art create registry -t CONTAINER$

Return the result as JSON
bdy artifact create my-artifact --format json$