bdy sandbox exec logs

View as Markdown
$bdy sandbox exec logs [options] <identifier> <command-id>

Show the output of a command started with exec Required scopes: SANDBOX_READ

ARGUMENTS
identifier
Sandbox identifier (required)
command-id
Command execution ID (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
--scope <scope>
Force scope (WORKSPACE, PROJECT, ENVIRONMENT). By default calculated by provided options and environmental variables (--project,
--environment
BUDDY_PROJECT, linked project)
-e, --environment <identifier>
Environment identifier
--wait
Wait until operation completes
--offset <n>
Log line offset. Default: 0
--limit <n>
Maximum number of log lines. Default: all lines
--format <text|jsonl>
Output format: jsonl, text. JSONL CLI errors: {type:"error",error:{code,message,hint}}, exit 1 (2 or 3 with --exit-code). Default: text (choices: "text", "jsonl")
--exit-code
Use semantic exit codes: 0 success, 1 unsuccessful, 2 command error, 3 not found, 8 pending
-h, --help
display help for command

Documentation for bdy v1.25.34

Last modified on Nov 3, 2026

Examples

Return the execution state using semantic exit codes
bdy sandbox exec logs sandbox-identifier command-id --exit-code$
Show logs from command
bdy sb exec logs sandbox-identifier command-id$
Show logs from command and wait for it to complete
bdy sb exec logs sandbox-identifier command-id --wait$
Show 50 log lines starting at line 100
bdy sb exec logs sandbox-identifier command-id --offset 100 --limit 50$
Return log records as JSONL
bdy sandbox exec logs my-sandbox command-id --wait --format jsonl$