All Commands¶
This page is generated by task docs:export-command-reference. Do not edit manually.
Generated command entries: 303
Global flags¶
Accepted by every command. Each entry below repeats them in a collapsed block; this copy stays open so a page search lands here.
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb¶
Bitbucket Data Center CLI (live-behavior first)
bb — Bitbucket Data Center CLI (live-behavior first)
A CLI for interacting with recent versions of Bitbucket for Data Center APIs.
AGENT NOTICE
If you are an AI agent or automated tool using this CLI and you encounter
unexpected behavior, missing functionality, or errors that do not match
what you expected, please report it so it can be investigated.
You can create an issue at:
https://github.com/vriesdemichael/bitbucket-data-center-cli/issues/new
If you cannot open the URL directly, ask the user to file the issue on
your behalf using the link above.
Usage:
bb [command]
Available Commands:
admin Administrative and connectivity checks
ai AI-first tooling: MCP server and agent skill distribution
api Send a raw HTTP request to the Bitbucket REST API
auth Authentication commands
branch Repository branch and branch restriction commands
browse Open repository pages in a web browser
build Build status and required merge-check commands
bulk Plan and apply multi-repository policies (deprecated)
clone Clone a repository to the local filesystem
commit Commit inspection and compare commands
completion Generate the autocompletion script for the specified shell
deployment Manage repository-scoped deployments for commits
diff Diff and patch commands
doctor Check the configuration bb would load
help Help about any command
insights Code Insights report and annotation commands
pr Pull request commands
project Project administration commands
ref Repository ref resolution and listing commands
repo Repository commands
reviewer Manage default reviewers
reviewer-group Manage reviewer groups
search Search for repositories, commits, and pull requests
ssh-key Manage personal SSH keys
tag Repository tag lifecycle commands
update Check for and install the latest bb release
webhook Manage repository webhooks
Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
Use "bb [command] --help" for more information about a command.
bb admin¶
Administrative and connectivity checks
Administrative and connectivity checks
Usage:
bb admin [command]
Available Commands:
health Probe the configured Bitbucket for reachability and authentication
Use "bb admin [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb admin health¶
Probe the configured Bitbucket for reachability and authentication
Probe the configured Bitbucket for reachability and authentication.
This was previously described as checking "local stack health", which it never did: it probes whichever host BITBUCKET_URL resolves to, wherever that is. The description was wrong, not the command.
bb auth status now reports the same thing and more — identity, credential storage, and whether git is set up to authenticate through bb — so prefer that. This stays for scripts that already call it.
Usage:
bb admin health [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ai¶
AI-first tooling: MCP server and agent skill distribution
AI-first tooling: MCP server and agent skill distribution
Usage:
bb ai [command]
Available Commands:
mcp MCP server commands
skill Agent skill distribution commands
Use "bb ai [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ai mcp¶
MCP server commands
MCP server commands
Usage:
bb ai mcp [command]
Available Commands:
serve Start the MCP server (stdio transport)
tools List available MCP tools with name, exposure and description
Use "bb ai mcp [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ai mcp serve¶
Start the MCP server (stdio transport)
Start the bb MCP server using stdio transport for IDE integration.
Configure your IDE's MCP client to run:
bb ai mcp serve
VS Code (settings.json):
"mcp": {
"servers": {
"bb": { "type": "stdio", "command": "bb", "args": ["ai", "mcp", "serve"] }
}
}
Give the server its own credential through the client's env block, which every
MCP client supports -- Claude Code and Claude Desktop (.mcp.json /
claude_desktop_config.json), Codex ([mcp_servers.bb.env] in config.toml, or
codex mcp add --env), and Antigravity (mcp_config.json):
"bb": {
"command": "bb",
"args": ["ai", "mcp", "serve"],
"env": { "BITBUCKET_TOKEN": "${BB_MCP_TOKEN}" }
}
The ${VAR} form is worth using deliberately: it keeps the agent on a different
PAT from your own, so the token you use interactively can carry write rights
while the one the agent gets is read-only, and neither is written into the
config file. Scoping the server this way replaces the old --token flag, which
put the credential in the process argument list for as long as the server ran
-- world-readable on Linux, unlike the process environment.
By default the server runs in safe mode: only tools whose side-effects are
low-blast-radius and easily reversed are exposed (e.g. create_pull_request,
add_pr_comment). Tools that perform irreversible operations such as
merge_pull_request are withheld unless --yolo is set.
Use --tools to expose a specific subset regardless of the safety classification.
Use --exclude to suppress individual tools in any mode.
When more than one Bitbucket instance is configured the --host flag is required.
Use --project or --repo to confine the server to one project or repository. Any
tool call aimed elsewhere is refused. Tools that address a resource Bitbucket
does not scope to a project — build statuses, which hang off a commit SHA — are
withheld entirely while a scope is set, because there is no argument to bound.
Confinement applies only when the flags are passed explicitly: the server is
never scoped by the repository of the directory it starts in.
Use --audit-file to record every tool call as JSON Lines for SIEM collection.
Pass a path, or 'stderr' for a containerised deployment whose log collector
reads the process streams. Auditing is off by default. When it is on and a
record cannot be written the call is refused; --audit-failure=warn relaxes that.
The audit trail covers this server only. An agent that can run shell commands
can invoke bb directly and bypass it, along with every other control here; the
control that survives that is the token itself, which binds at the Bitbucket
server -- give this server a narrower PAT than your own through env.
Usage:
bb ai mcp serve [flags]
Flags:
--allow-writes Alias for --yolo
--audit-failure string What to do when an audit record cannot be written (one of: deny, warn) (default "deny")
--audit-file string Append a JSON Lines audit record per tool call to this path, or to 'stderr'
--exclude string Comma-separated denylist of tool names to suppress
--host string Target Bitbucket instance URL; required when multiple instances are configured
--project string Confine the server to this project key; calls aimed elsewhere are refused
--repo string Confine the server to one repository, as PROJECT/slug (or a slug alongside --project)
--tools string Comma-separated allowlist of tool names to expose (overrides safety filter)
--yolo Expose all tools including unsafe operations like merge_pull_request
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ai mcp tools¶
List available MCP tools with name, exposure and description
Print all MCP tools the serve command can expose.
Use this output to build --tools and --exclude allowlists/denylists.
EXPOSURE says when a tool is available, and ACCESS whether it changes anything:
SAFE exposed by default. Some of these write -- opening a pull request,
commenting, tagging -- but none changes a branch or causes a merge
YOLO withheld unless 'bb ai mcp serve --yolo' (or --allow-writes) is set,
because it cannot be undone, causes a merge, or feeds a check that
decides whether one is allowed
--tools takes precedence over the safety filter, so naming a YOLO tool in an
allowlist exposes it without --yolo. Pass --safe-only to list just the set the
server exposes by default.
Usage:
bb ai mcp tools [flags]
Flags:
--safe-only List only the tools the server exposes without --yolo
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ai skill¶
Agent skill distribution commands
Agent skill distribution commands
Usage:
bb ai skill [command]
Available Commands:
install Write an agent skill to the agent skills directory
remove Remove an installed agent skill file
show Print an agent skill to stdout
Use "bb ai skill [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ai skill install¶
Write an agent skill to the agent skills directory
Write an agent skill file to the appropriate directory (defaults to "bb", supports "bulk" / "bb-bulk").
Project scope (default):
.agents/skills/<skill>/SKILL.md
Global scope (--global):
~/.agents/skills/<skill>/SKILL.md
The skill is embedded in this binary, so no network connection is required.
Re-run after upgrading bb to keep the skill file current.
Usage:
bb ai skill install [skill] [flags]
Flags:
--global Install to user-level path (~/.agents/skills/<skill>/SKILL.md)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ai skill remove¶
Remove an installed agent skill file
Remove an installed agent skill file
Usage:
bb ai skill remove [skill] [flags]
Flags:
--global Remove from user-level path (~/.agents/skills/<skill>/SKILL.md)
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ai skill show¶
Print an agent skill to stdout
Print an agent skill to stdout (defaults to "bb", supports "bulk" / "bb-bulk").
The skill is embedded in this binary at compile time, so it works with no
network connection and without the source repository present.
Redirect to the location your coding agent expects:
bb ai skill show > .agents/skills/bb/SKILL.md
bb ai skill show bulk > .agents/skills/bb-bulk/SKILL.md
Most agents use .agents/skills/<name>/SKILL.md as the project-scoped path.
Some use agent-specific paths (e.g. .claude/skills/, .cursor/skills/).
Consult your agent's documentation if the above path does not work.
Baseline skills (fixed at release time) are also distributed via the open
agent skills ecosystem and can be installed without bb being present:
npx skills add vriesdemichael/bitbucket-data-center-cli
The npx-installed files are snapshots from the repository. Use this command
to get a skill that always matches your installed bb version.
Usage:
bb ai skill show [skill] [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb api¶
Send a raw HTTP request to the Bitbucket REST API
Send a raw HTTP request to the Bitbucket REST API as an escape hatch for uncovered endpoints.
Reuses stored authentication, host aliases, TLS options, retries, and pagination.
Field arguments:
-f, --raw-field k=v Pass a string parameter (query parameter for GET, JSON field for POST/PUT/DELETE)
-F, --field k=v Pass a typed parameter (parses booleans, numbers, null, JSON, or @file)
-H, --header k:v Pass a custom HTTP header
--input file Pass a request body from a file (or '-' for stdin)
--paginate Automatically fetch all pages for paginated endpoints
--host url Target a specific Bitbucket host URL
Note: On Windows Git Bash (MSYS2), set MSYS_NO_PATHCONV=1 or omit the leading slash (e.g. rest/api/1.0/...) to prevent shell path mangling.
Usage:
bb api <path> [flags]
Examples:
# GET a pull request settings resource
bb api /rest/api/1.0/projects/PROJ/repos/repo/settings/pull-requests
# Target a specific Bitbucket instance
bb api /rest/api/1.0/projects --host https://bitbucket.example.com
# Paginate all admin groups
bb api /rest/api/1.0/admin/groups --paginate
# POST with typed JSON body fields
bb api /rest/api/1.0/projects/PROJ/repos/repo/branches -X POST -F name=feature/test -F startPoint=main
# POST with JSON payload from file or stdin
bb api /rest/api/1.0/projects/PROJ/repos/repo/branches --method POST --input body.json
cat body.json | bb api /rest/api/1.0/projects/PROJ/repos/repo/branches -X POST --input -
Flags:
-F, --field stringArray Add a typed parameter (key=value, booleans, numbers, null, or @file)
-H, --header stringArray Add a custom HTTP request header (Name: Value)
--host string Bitbucket host URL
--input string File to use as request body (or '-' for stdin)
-X, --method string HTTP method (one of: GET, POST, PUT, DELETE, PATCH, HEAD)
--paginate Automatically fetch all pages for paginated endpoints
-f, --raw-field stringArray Add a string parameter (key=value)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth¶
Authentication commands
Authentication commands
Usage:
bb auth [command]
Available Commands:
alias Manage host aliases for a stored server context
git-credential Git credential helper (invoked by git, not run directly)
gpg-key Manage personal GPG keys
identity Show authenticated user identity
login Store credentials for a Bitbucket host
logout Remove stored credentials for a Bitbucket host
server Manage server contexts
setup-git Configure git to authenticate to Bitbucket through bb
status Show the configured target and verify it works
token Manage HTTP access tokens
token-url Show personal access token creation URL
Use "bb auth [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth alias¶
Manage host aliases for a stored server context
Manage host aliases for a stored server context
Usage:
bb auth alias [command]
Available Commands:
add Add aliases to a stored server context
discover Discover aliases from the first accessible repository clone links
list List aliases for a stored server context
remove Remove an alias from a stored server context
Use "bb auth alias [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth alias add¶
Add aliases to a stored server context
Add aliases to a stored server context
Usage:
bb auth alias add <alias> [alias...] [flags]
Flags:
--host string Bitbucket host URL
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth alias discover¶
Discover aliases from the first accessible repository clone links
Discover aliases from the first accessible repository clone links.
Discovered aliases are added to the ones already stored. Aliases added by hand are kept, because discovery cannot find every alias -- an instance whose SSH clone host differs from its web URL is the documented case for adding one manually, and it would be undone by every later discovery run.
Pass --replace to store only what was discovered. Anything dropped is named in the output.
Usage:
bb auth alias discover [flags]
Flags:
--host string Bitbucket host URL
--replace Store only the discovered aliases, dropping any others
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth alias list¶
List aliases for a stored server context
List aliases for a stored server context
Usage:
bb auth alias list [flags]
Flags:
--host string Bitbucket host URL
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth alias remove¶
Remove an alias from a stored server context
Remove an alias from a stored server context
Usage:
bb auth alias remove <alias> [flags]
Flags:
--host string Bitbucket host URL
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth git-credential¶
Git credential helper (invoked by git, not run directly)
Supply stored Bitbucket credentials to git on demand.
git invokes this; you do not normally run it yourself. Configure it with:
bb auth setup-git
Credentials are read from the same place `bb auth login` stores them, so git and
bb stay in agreement and no token is ever written into a repository.
Usage:
bb auth git-credential <get|store|erase> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth gpg-key¶
Manage personal GPG keys
Manage personal GPG keys
Usage:
bb auth gpg-key [command]
Available Commands:
add Add a personal GPG key
clear Clear all personal GPG keys
list List personal GPG keys
remove Remove a personal GPG key
Use "bb auth gpg-key [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth gpg-key add¶
Add a personal GPG key
Add a personal GPG key
Usage:
bb auth gpg-key add <key-file-or-text> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth gpg-key clear¶
Clear all personal GPG keys
Clear all personal GPG keys
Usage:
bb auth gpg-key clear [flags]
Flags:
-y, --yes Confirm clearing of all GPG keys
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth gpg-key list¶
List personal GPG keys
List personal GPG keys
Usage:
bb auth gpg-key list [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth gpg-key remove¶
Remove a personal GPG key
Remove a personal GPG key
Usage:
bb auth gpg-key remove <id-or-fingerprint> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth identity¶
Show authenticated user identity
Show authenticated user identity
Usage:
bb auth identity [flags]
Aliases:
identity, whoami
Flags:
--host string Override host for this identity check
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth login¶
Store credentials for a Bitbucket host
Store credentials for a Bitbucket host.
Prefer the stdin forms. A secret passed as a flag value appears in the process
argument list, where any local user can read it through ps or /proc, and where
the shell records it in history:
printf '%s' "$BITBUCKET_TOKEN" | bb auth login https://bitbucket.example.com --token-stdin
Credentials are stored in the OS keyring. Where no keyring is available — headless
servers, most containers, WSL without gnome-keyring — bb falls back to the config
file in plaintext and says so. Pass --require-keyring (or set BB_REQUIRE_KEYRING=1)
to fail instead of falling back.
Usage:
bb auth login <host> [flags]
Flags:
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--discover-aliases Discover host aliases from the first accessible repository clone links (default true)
--password-stdin Read the basic-auth password from stdin
--require-keyring Fail if the OS keyring is unavailable instead of storing credentials in plaintext
--set-default Set host as default target (default true)
--token-stdin Read the access token from stdin
--username string Username for basic auth
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth logout¶
Remove stored credentials for a Bitbucket host
Remove stored credentials for a Bitbucket host
Usage:
bb auth logout [flags]
Flags:
--host string Bitbucket host URL (defaults to stored default host)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth server¶
Manage server contexts
Manage server contexts
Usage:
bb auth server [command]
Available Commands:
list List stored server contexts
use Set the active default server context
Use "bb auth server [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth server list¶
List stored server contexts
List stored server contexts
Usage:
bb auth server list [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth server use¶
Set the active default server context
Set the active default server context
Usage:
bb auth server use [host] [flags]
Flags:
--host string Bitbucket host URL
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth setup-git¶
Configure git to authenticate to Bitbucket through bb
Configure git to ask bb for Bitbucket credentials.
This replaces the need to embed credentials in a repository or in a remote URL.
The configuration is scoped to the Bitbucket host, so git never offers these
credentials to any other remote.
Usage:
bb auth setup-git [flags]
Flags:
--force Overwrite an existing credential helper for this host
--global Write to global git config rather than the current repository (default true)
--host string Bitbucket host URL (defaults to the configured host)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth status¶
Show the configured target and verify it works
Show the configured target and verify it works.
Reports the resolved host, how the credential is stored, whether that credential
still authenticates, and whether git is set up to authenticate through bb.
Reporting alone is not enough to be useful: an expired token, an unreachable
host and a working setup used to produce the same confident output. Each line
now says which it is, and what to do when it is not the last one.
Lines marked ! are advisory: they report something worth knowing that does not
mean the setup is broken. The git credential helper is one — it is needed to git
push and irrelevant to anything that only calls the API — so it is reported but
never fails the command.
Exit status is unchanged by default, so existing scripts keep working. Pass
--check to exit non-zero when a non-advisory check fails, which is the form
worth putting in CI.
Under --json the exit status is always zero and the verdict is the "ok" field.
Machine output is a single document on stdout, so a failing exit would replace
the findings with an error envelope — losing exactly the detail that was asked
for.
Usage:
bb auth status [flags]
Flags:
--check Exit non-zero when a check fails (for CI)
--host string Override host for this status check
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth token¶
Manage HTTP access tokens
Manage HTTP access tokens
Usage:
bb auth token [command]
Available Commands:
create Create an HTTP access token
get Get an HTTP access token by ID
list List HTTP access tokens
revoke Revoke an HTTP access token by ID
update Update an HTTP access token name or permissions
Flags:
--project string Project key for project access token scope
--repo string Repository reference (projectKey/repositorySlug) for repository access token scope
--user string User slug for personal access token scope
Use "bb auth token [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb auth token create¶
Create an HTTP access token
Create an HTTP access token
Usage:
bb auth token create [name] [flags]
Flags:
--expiry-days int Number of days before the token expires (0 for never)
--name string Name of the access token
--permission strings Permissions to grant (repeat flag or separate with commas)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key for project access token scope
--repo string Repository reference (projectKey/repositorySlug) for repository access token scope
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--user string User slug for personal access token scope
bb auth token get¶
Get an HTTP access token by ID
Get an HTTP access token by ID
Usage:
bb auth token get <id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key for project access token scope
--repo string Repository reference (projectKey/repositorySlug) for repository access token scope
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--user string User slug for personal access token scope
bb auth token list¶
List HTTP access tokens
List HTTP access tokens
Usage:
bb auth token list [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key for project access token scope
--repo string Repository reference (projectKey/repositorySlug) for repository access token scope
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--user string User slug for personal access token scope
bb auth token revoke¶
Revoke an HTTP access token by ID
Revoke an HTTP access token by ID
Usage:
bb auth token revoke <id> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key for project access token scope
--repo string Repository reference (projectKey/repositorySlug) for repository access token scope
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--user string User slug for personal access token scope
bb auth token update¶
Update an HTTP access token name or permissions
Update an HTTP access token name or permissions
Usage:
bb auth token update <id> [flags]
Flags:
--name string New name for the access token
--permission strings New permissions to set (repeat flag or separate with commas)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key for project access token scope
--repo string Repository reference (projectKey/repositorySlug) for repository access token scope
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--user string User slug for personal access token scope
bb auth token-url¶
Show personal access token creation URL
Show personal access token creation URL
Usage:
bb auth token-url [flags]
Flags:
--host string Bitbucket host URL
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb branch¶
Repository branch and branch restriction commands
Repository branch and branch restriction commands
Usage:
bb branch [command]
Available Commands:
create Create repository branch
default Get or set repository default branch
delete Delete repository branch
list List repository branches
model Inspect and update branch model-related settings
restriction Manage repository branch restrictions
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--start int Start offset for list operations
Use "bb branch [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb branch create¶
Create repository branch
Create repository branch
Usage:
bb branch create <name> [flags]
Flags:
--start-point string Commit ID or ref to branch from
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb branch default¶
Get or set repository default branch
Get or set repository default branch
Usage:
bb branch default [command]
Available Commands:
get Get repository default branch
set Set repository default branch
Use "bb branch default [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb branch default get¶
Get repository default branch
Get repository default branch
Usage:
bb branch default get [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb branch default set¶
Set repository default branch
Set repository default branch
Usage:
bb branch default set <name> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb branch delete¶
Delete repository branch
Delete repository branch
Usage:
bb branch delete <name> [flags]
Flags:
--end-point string Expected commit at branch tip
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb branch list¶
List repository branches
List repository branches
Usage:
bb branch list [flags]
Flags:
--all Return every result rather than the first --limit
--base string Base ref filter
--details Include branch details from Bitbucket
--filter string Filter text for branch names
--limit int Maximum number of results to return (default 25)
--order-by string Branch ordering (one of: ALPHABETICAL, MODIFICATION)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb branch model¶
Inspect and update branch model-related settings
Inspect and update branch model-related settings
Usage:
bb branch model [command]
Available Commands:
inspect Show the branch a commit belongs to
update Update repository default branch used by branch model settings
Use "bb branch model [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb branch model inspect¶
Show the branch a commit belongs to
Show the branch a commit belongs to
Usage:
bb branch model inspect <commit> [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb branch model update¶
Update repository default branch used by branch model settings
Update repository default branch used by branch model settings
Usage:
bb branch model update <default-branch> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb branch restriction¶
Manage repository branch restrictions
Manage repository branch restrictions
Usage:
bb branch restriction [command]
Available Commands:
create Create branch restriction
delete Delete branch restriction
get Get branch restriction by id
list List branch restrictions
update Update branch restriction
Use "bb branch restriction [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb branch restriction create¶
Create branch restriction
Create branch restriction
Usage:
bb branch restriction create [flags]
Flags:
--access-key-id ints SSH access key id allowed by restriction (repeatable)
--group strings Group name allowed by restriction (repeatable)
--matcher-display string Matcher display value
--matcher-id string Matcher id value
--matcher-type string Matcher type (one of: BRANCH, MODEL_BRANCH, MODEL_CATEGORY, PATTERN) (default "BRANCH")
--type string Restriction type (one of: read-only, no-deletes, fast-forward-only, pull-request-only, no-creates)
--user strings User slug allowed by restriction (repeatable)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb branch restriction delete¶
Delete branch restriction
Delete branch restriction
Usage:
bb branch restriction delete <id> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb branch restriction get¶
Get branch restriction by id
Get branch restriction by id
Usage:
bb branch restriction get <id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb branch restriction list¶
List branch restrictions
List branch restrictions
Usage:
bb branch restriction list [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--matcher-id string Matcher id value
--matcher-type string Matcher type (one of: BRANCH, MODEL_BRANCH, MODEL_CATEGORY, PATTERN)
--type string Restriction type (one of: read-only, no-deletes, fast-forward-only, pull-request-only, no-creates)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb branch restriction update¶
Update branch restriction
Update branch restriction
Usage:
bb branch restriction update <id> [flags]
Flags:
--access-key-id ints SSH access key id allowed by restriction (repeatable)
--group strings Group name allowed by restriction (repeatable)
--matcher-display string Matcher display value
--matcher-id string Matcher id value
--matcher-type string Matcher type (one of: BRANCH, MODEL_BRANCH, MODEL_CATEGORY, PATTERN)
--type string Restriction type (one of: read-only, no-deletes, fast-forward-only, pull-request-only, no-creates)
--user strings User slug allowed by restriction (repeatable)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb browse¶
Open repository pages in a web browser
Open repository pages in a web browser
Usage:
bb browse [<number> | <path> | <commit-sha>] [flags]
Flags:
--blame Open blame view for a file
-b, --branch string Select another branch
-c, --commit string Select another commit
-n, --no-browser Print destination URL instead of opening the browser
-r, --releases Open repository tags/releases view
-R, --repo string Repository as [HOST/]PROJECT/slug (defaults to inferred repository context)
-s, --settings Open repository settings
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb build¶
Build status and required merge-check commands
Build status and required merge-check commands
Usage:
bb build [command]
Available Commands:
delete Delete repository-scoped build status by key
get Get repository-scoped build status by key
required Required build merge-check management
set Set repository-scoped build status for a commit
status Build status commands by commit
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb build [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb build delete¶
Delete repository-scoped build status by key
Delete repository-scoped build status by key
Usage:
bb build delete <commit> [flags]
Flags:
--key string Build status key
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb build get¶
Get repository-scoped build status by key
Get repository-scoped build status by key
Usage:
bb build get <commit> [flags]
Flags:
--key string Build status key
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb build required¶
Required build merge-check management
Required build merge-check management
Usage:
bb build required [command]
Available Commands:
create Create required build merge check
delete Delete required build merge check
list List required build merge checks
update Update required build merge check
Use "bb build required [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb build required create¶
Create required build merge check
Create required build merge check
Usage:
bb build required create [flags]
Flags:
--body string Raw JSON payload for required build merge check
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb build required delete¶
Delete required build merge check
Delete required build merge check
Usage:
bb build required delete <id> [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb build required list¶
List required build merge checks
List required build merge checks
Usage:
bb build required list [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb build required update¶
Update required build merge check
Update required build merge check
Usage:
bb build required update <id> [flags]
Flags:
--body string Raw JSON payload for required build merge check
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb build set¶
Set repository-scoped build status for a commit
Set repository-scoped build status for a commit
Usage:
bb build set <commit> [flags]
Flags:
--build-number string Build number
--description string Build description
--duration-ms int Duration in milliseconds
--key string Build status key
--name string Build display name
--parent string Build parent key
--ref string Build ref
--state string Build state (one of: SUCCESSFUL, FAILED, INPROGRESS, CANCELLED, UNKNOWN)
--url string Build URL
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb build status¶
Build status commands by commit
Build status commands by commit
Usage:
bb build status [command]
Available Commands:
get Get build statuses for a commit
set Set build status for a commit
stats Get build status summary counts for one or more commits
Flags:
--include-unique Include unique result details when available
Use "bb build status [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb build status get¶
Get build statuses for a commit
Get build statuses for a commit
Usage:
bb build status get <commit> [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--order-by string Build status ordering (one of: NEWEST, OLDEST, STATUS)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--include-unique Include unique result details when available
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb build status set¶
Set build status for a commit
Set build status for a commit
Usage:
bb build status set <commit> [flags]
Flags:
--build-number string Build number
--description string Build description
--duration-ms int Duration in milliseconds
--key string Build status key
--name string Build display name
--parent string Build parent key
--ref string Build ref
--state string Build state (one of: SUCCESSFUL, FAILED, INPROGRESS, CANCELLED, UNKNOWN)
--url string Build URL
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--include-unique Include unique result details when available
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb build status stats¶
Get build status summary counts for one or more commits
Get build status summary counts for one or more commits
Usage:
bb build status stats <commit>... [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--include-unique Include unique result details when available
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb bulk¶
Plan and apply multi-repository policies (deprecated)
Plan and apply multi-repository policies (deprecated)
Usage:
bb bulk [command]
Available Commands:
apply Apply operations from a reviewed bulk plan
plan Resolve a bulk policy into a deterministic reviewed plan
status Show the saved status for a prior bulk apply operation
Use "bb bulk [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb bulk apply¶
Apply operations from a reviewed bulk plan
Apply operations from a reviewed bulk plan
Usage:
bb bulk apply [flags]
Flags:
--from-plan string Path to reviewed bulk plan JSON file
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb bulk plan¶
Resolve a bulk policy into a deterministic reviewed plan
Resolve a bulk policy into a deterministic reviewed plan
Usage:
bb bulk plan [flags]
Flags:
-f, --file string Path to bulk policy YAML file
-o, --output string Optional path to write the reviewed plan JSON artifact
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb bulk status¶
Show the saved status for a prior bulk apply operation
Show the saved status for a prior bulk apply operation
Usage:
bb bulk status <operation-id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb clone¶
Clone a repository to the local filesystem
Clone a repository to the local filesystem
Usage:
bb clone <repository> [directory] [-- <gitflags>...] [flags]
Flags:
--https Use HTTPS only and skip the SSH clone attempt
--no-upstream Do not add an upstream remote when cloning a fork
--ssh Use SSH only and disable HTTPS fallback
-u, --upstream-remote-name string Upstream remote name when cloning a fork (default "upstream")
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb commit¶
Commit inspection and compare commands
Commit inspection and compare commands
Usage:
bb commit [command]
Available Commands:
compare Compare two commits or refs
get Get a specific commit
list List repository commits
prs List pull requests containing a commit
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--start int Start offset for list operations
Use "bb commit [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb commit compare¶
Compare two commits or refs
List the commits reachable from <from> but not from <to>: what <from> has
that <to> lacks. Pass the ref you are asking about first; git log's range puts
it last.
bb commit compare feature/x main # commits feature/x adds
bb commit compare <failing> <green> # commits since the last green build
Usage:
bb commit compare <from> <to> [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb commit get¶
Get a specific commit
Get a specific commit
Usage:
bb commit get <id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb commit list¶
List repository commits
List repository commits
Usage:
bb commit list [flags]
Flags:
--all Return every result rather than the first --limit
--jira string List commits associated with a Jira issue key
--limit int Maximum number of results to return (default 25)
--path string Filter commits by file path
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb commit prs¶
List pull requests containing a commit
List pull requests containing a commit
Usage:
bb commit prs <commitId> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
--start int Start offset for list operations
bb deployment¶
Manage repository-scoped deployments for commits
Manage repository-scoped deployments for commits
Usage:
bb deployment [command]
Available Commands:
create Create or update a repository-scoped deployment for a commit
delete Delete repository-scoped deployment for a commit
get Get repository-scoped deployment details for a commit
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb deployment [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb deployment create¶
Create or update a repository-scoped deployment for a commit
Create or update a repository-scoped deployment for a commit
Usage:
bb deployment create <commit> [flags]
Flags:
--deployment-sequence-number int Sequence number of the deployment
--description string Description of the deployment
--display-name string Display name of the deployment
--env-key string Environment key
--env-name string Environment display name
--env-type string Environment type (one of: PRODUCTION, STAGING, TESTING, DEVELOPMENT, UNKNOWN)
--env-url string Environment URL
--key string Deployment key
--state string Deployment state (one of: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED, ROLLED_BACK, UNKNOWN)
--url string Deployment URL
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb deployment delete¶
Delete repository-scoped deployment for a commit
Delete repository-scoped deployment for a commit
Usage:
bb deployment delete <commit> [flags]
Flags:
--deployment-sequence-number string Identify by deployment sequence number
--env-key string Identify by environment key
--key string Identify by deployment key
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb deployment get¶
Get repository-scoped deployment details for a commit
Get repository-scoped deployment details for a commit
Usage:
bb deployment get <commit> [flags]
Flags:
--deployment-sequence-number string Filter by deployment sequence number
--env-key string Filter by environment key
--key string Filter by deployment key
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb diff¶
Diff and patch commands
Diff and patch commands
Usage:
bb diff [command]
Available Commands:
commit Diff a commit against its parent
pr Diff a pull request
refs Diff two refs or commits
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb diff [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb diff commit¶
Diff a commit against its parent
Diff a commit against its parent
Usage:
bb diff commit <sha> [flags]
Flags:
--path string Optional file path for file-scoped diff
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb diff pr¶
Diff a pull request
Diff a pull request.
Also available as bb pr diff, which is the gh spelling.
Usage:
bb diff pr <id> [flags]
Flags:
--name-only Output only changed file names
--patch Output unified patch stream
--stat Output structured diff stats
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb diff refs¶
Diff two refs or commits
Diff two refs or commits
Usage:
bb diff refs <from> <to> [flags]
Flags:
--name-only Output only changed file names
--patch Output unified patch stream
--path string Optional file path for file-scoped diff
--stat Output structured diff stats
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb doctor¶
Check the configuration bb would load
Check the configuration bb would load, and report everything wrong with it at once.
A command that loads the configuration stops at the first file it cannot use.
bb doctor reads the stored, workspace and system configuration files on their
own and reports, for each, where it is, whether it parses, and every key the
configuration schema rejects, with its line. It lists keys that are valid but
not read from the file they are in: policy set in your own file mandates
nothing.
It then shows where each effective setting comes from -- a flag, an environment
variable, a .env file, a configuration file, the Windows registry or the
built-in default -- and what it overrides. When keyring-backed storage is
required, it checks that the OS keyring can be reached.
It needs no configured host, never contacts Bitbucket, and never prints a
secret: a token or password is reported as configured, with where it is held.
Exit status is 0 only when there is nothing to fix. Any issue the report shows
-- an invalid file, a key its file never reads, a setting a command would
refuse, a required keyring that cannot be reached -- exits 1. Under --json a
run with issues writes the failure envelope instead of the report: its message
summarises the issues, and error.details names each one under its own key,
file/<file>, violation/<file>/<key path>, ignored/<file>/<key>, setting/<name>
or keyring, with the key path written as a JSON Pointer.
Usage:
bb doctor [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb insights¶
Code Insights report and annotation commands
Code Insights report and annotation commands
Usage:
bb insights [command]
Available Commands:
annotation Code Insights annotation commands
report Code Insights report commands
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb insights [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb insights annotation¶
Code Insights annotation commands
Code Insights annotation commands
Usage:
bb insights annotation [command]
Available Commands:
add Add annotations to a Code Insights report
delete Delete annotation(s) by external id for a report
list List annotations for a Code Insights report or commit
set Create or replace a Code Insights report annotation
Use "bb insights annotation [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb insights annotation add¶
Add annotations to a Code Insights report
Add annotations to a Code Insights report
Usage:
bb insights annotation add <commit> <key> [flags]
Flags:
--body string Raw JSON array payload for annotations
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb insights annotation delete¶
Delete annotation(s) by external id for a report
Delete annotation(s) by external id for a report
Usage:
bb insights annotation delete <commit> <key> [flags]
Flags:
--external-id string External annotation ID to delete
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb insights annotation list¶
List annotations for a Code Insights report or commit
List annotations for a Code Insights report or commit
Usage:
bb insights annotation list <commit> [key] [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb insights annotation set¶
Create or replace a Code Insights report annotation
Create or replace a Code Insights report annotation
Usage:
bb insights annotation set <commit> <key> <external-id> [flags]
Flags:
--line int32 Line number containing the annotation
--link string Link associated with the annotation
--message string Annotation message
--path string File path containing the annotation
--severity string Annotation severity (one of: LOW, MEDIUM, HIGH)
--type string Annotation type (one of: BUG, CODE_SMELL, VULNERABILITY)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb insights report¶
Code Insights report commands
Code Insights report commands
Usage:
bb insights report [command]
Available Commands:
delete Delete a Code Insights report
get Get a Code Insights report
list List Code Insights reports for a commit
set Create or update a Code Insights report
Use "bb insights report [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb insights report delete¶
Delete a Code Insights report
Delete a Code Insights report
Usage:
bb insights report delete <commit> <key> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb insights report get¶
Get a Code Insights report
Get a Code Insights report
Usage:
bb insights report get <commit> <key> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb insights report list¶
List Code Insights reports for a commit
List Code Insights reports for a commit
Usage:
bb insights report list <commit> [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb insights report set¶
Create or update a Code Insights report
Create or update a Code Insights report
Usage:
bb insights report set <commit> <key> [flags]
Flags:
--body string Raw JSON payload for Code Insights report
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr¶
Pull request commands
Pull request commands
Usage:
bb pr [command]
Available Commands:
activity Pull request activity commands
auto-merge Pull request auto-merge commands (Bitbucket DC 8.0+)
build Pull request build status commands
checkout Check out a pull request branch locally
checks Show build statuses for a pull request's source commit (alias for bb pr build status)
comment Pull request comment commands
commits List the commits in a pull request
create Create a pull request
decline Decline a pull request
default-reviewers List default reviewers and matching conditions for repository
diff Diff a pull request (alias for bb diff pr)
files List the files changed in a pull request
get Get pull request details, including outstanding review feedback
jira List Jira issues associated with a pull request
list List pull requests
merge Merge a pull request
merge-base Show the common ancestor commit of a pull request's source and target branches
participants Search pull request participants across a repository
ready Mark a draft pull request ready for review, or turn it back into a draft
rebase Rebase a pull request
reopen Reopen a pull request
review Pull request review commands
status Show pull requests waiting on you
unwatch Unwatch a pull request
update Update pull request metadata
watch Watch a pull request
Flags:
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
Use "bb pr [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr activity¶
Pull request activity commands
Pull request activity commands. This is an explicit exception to the stable versioned API and is intended only for AI ingestion and debugging.
Usage:
bb pr activity [command]
Available Commands:
list List raw pull request activity items
Use "bb pr activity [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr activity list¶
List raw pull request activity items
List raw pull request activity items. This output is an explicit exception to the stable versioned API and is intended only for AI ingestion and debugging.
Usage:
bb pr activity list <id> [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr auto-merge¶
Pull request auto-merge commands (Bitbucket DC 8.0+)
Pull request auto-merge commands (Bitbucket DC 8.0+)
Usage:
bb pr auto-merge [command]
Available Commands:
disable Disable auto-merge on a pull request
enable Enable auto-merge on a pull request
get Get auto-merge configuration for a pull request
Use "bb pr auto-merge [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr auto-merge disable¶
Disable auto-merge on a pull request
Disable auto-merge on a pull request
Usage:
bb pr auto-merge disable <id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr auto-merge enable¶
Enable auto-merge on a pull request
Enable auto-merge on a pull request
Usage:
bb pr auto-merge enable <id> [flags]
Examples:
# Enable auto-merge with the default strategy (no-ff)
bb pr auto-merge enable 42 --repo PROJ/repo
# Enable auto-merge with a specific strategy
bb pr auto-merge enable 42 --repo PROJ/repo --strategy rebase-ff-only
Flags:
--strategy string Merge strategy (one of: no-ff, ff, ff-only, rebase-no-ff, rebase-ff-only, squash, squash-ff-only) (default "no-ff")
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr auto-merge get¶
Get auto-merge configuration for a pull request
Get auto-merge configuration for a pull request
Usage:
bb pr auto-merge get <id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr build¶
Pull request build status commands
Pull request build status commands
Usage:
bb pr build [command]
Available Commands:
status Show build statuses for a pull request's source commit (also available as bb pr checks)
Use "bb pr build [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr build status¶
Show build statuses for a pull request's source commit (also available as bb pr checks)
Show build statuses for a pull request's source commit (also available as bb pr checks)
Usage:
bb pr build status <id> [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr checkout¶
Check out a pull request branch locally
Check out the source branch of a pull request in the current git repository.
Same-repository pull requests are checked out from the remote that already points at the repository. Pull requests from a fork fetch from the fork, adding a remote for it when one is not configured yet, so a later git push goes back to the fork branch the pull request is built from.
The fetch uses the credentials bb is already authenticated with, so no git credential setup is needed first. Pushing afterwards is plain git and does need one: run bb auth setup-git once.
Usage:
bb pr checkout <id> [flags]
Flags:
--branch string Local branch name to use (defaults to the pull request source branch)
--detach Check out the source commit without creating or moving a local branch
--force Check out even when tracked files have uncommitted changes, discarding them
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr checks¶
Show build statuses for a pull request's source commit (alias for bb pr build status)
Show build statuses for a pull request's source commit (alias for bb pr build status)
Usage:
bb pr checks <id> [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr comment¶
Pull request comment commands
Pull request comment commands
Usage:
bb pr comment [command]
Available Commands:
add Add a comment to a pull request
apply-suggestion Apply a suggested change from a comment
get Get a pull request comment
list List comment threads for a pull request, unresolved first
react Add or remove a reaction on a pull request comment
reopen Reopen a resolved pull request comment
resolve Resolve a pull request comment, closing it as a task
Use "bb pr comment [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr comment add¶
Add a comment to a pull request
Add a comment to a pull request.
Pass --path and --line to anchor the comment to a file and line, or --parent-id
to reply to an existing comment. Bitbucket only accepts an anchor on a line that
appears in the pull request diff, so the line has to be inside a changed hunk and
--line-type has to match the side it is on.
Usage:
bb pr comment add <pr-id> [flags]
Examples:
# A pull-request-level comment
bb pr comment add 49 --repo PROJ/repo --text "Looks good overall."
# Anchored to a line in the diff
bb pr comment add 49 --repo PROJ/repo --path app/core/runner.py --line 157 \
--text "This raises after the execution is recorded."
# A line that only exists in the original file
bb pr comment add 49 --repo PROJ/repo --path app/core/runner.py --line 88 \
--line-type REMOVED --text "Why was this dropped?"
# Reply to an existing comment
bb pr comment add 49 --repo PROJ/repo --parent-id 1389396 --text "Agreed, fixed."
Flags:
--blocker Mark the comment as a blocker
--line int Line number for an inline comment
--line-type string Line type for an inline comment, ADDED when not given (one of: ADDED, REMOVED, CONTEXT)
--parent-id int Parent comment ID to reply to
--path string File path for an inline comment
--pending Mark the comment as pending (draft)
--text string Comment text
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr comment apply-suggestion¶
Apply a suggested change from a comment
Apply a suggested change from a comment
Usage:
bb pr comment apply-suggestion <pr-id> <comment-id> [flags]
Flags:
--comment-version int32 Optional expected version of the comment
--commit-message string Commit message for the applied suggestion (default: names the comment)
--index int32 Optional index of the suggestion in the comment (default 0)
--pr-version int32 Optional expected version of the pull request
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr comment get¶
Get a pull request comment
Get a single pull request comment by id. This is the authoritative single-comment view and is better suited than list output when you need the full rendered comment payload.
Usage:
bb pr comment get <pr-id> <comment-id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr comment list¶
List comment threads for a pull request, unresolved first
List pull request comment threads. Bitbucket models a task as a blocker comment, so this returns reviewer comments and tasks in one view, each with its resolution state, anchor and reply count.
Without --path this uses the pull request activity timeline to return the aggregate comment view. With --path it uses the path-scoped comments endpoint. With --blocker it lists blocker comments.
Use --unresolved to show only threads still waiting on someone. Use --full to add every comment ungrouped, alongside the thread view rather than in place of it.
Usage:
bb pr comment list <id> [flags]
Flags:
--all Return every result rather than the first --limit
--blocker List pull request blocker comments
--full Add every comment ungrouped, alongside the thread view
--limit int Maximum number of results to return (default 25)
--path string Optional file path for path-scoped pull request comment listing
--state string Filter threads by resolution state (one of: open, unresolved, resolved, pending, all) (default "all")
--tasks-only Show only threads Bitbucket tracks as tasks (blocker comments)
--unresolved Show only unresolved threads (shorthand for --state open)
--with-replies Include the full text of every reply instead of only the most recent one
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr comment react¶
Add or remove a reaction on a pull request comment
Add or remove a reaction on a pull request comment
Usage:
bb pr comment react <pr-id> <comment-id> <emoji> [flags]
Flags:
--remove Remove the reaction instead of adding it
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr comment reopen¶
Reopen a resolved pull request comment
Reopen a resolved pull request comment
Usage:
bb pr comment reopen <pr-id> <comment-id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr comment resolve¶
Resolve a pull request comment, closing it as a task
Resolve a pull request comment, closing it as a task
Usage:
bb pr comment resolve <pr-id> <comment-id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr commits¶
List the commits in a pull request
List the commits in a pull request
Usage:
bb pr commits <id> [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--start int Start offset for the pull request commit listing
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr create¶
Create a pull request
Create a pull request
Usage:
bb pr create [flags]
Examples:
# Create a pull request (automatically includes default reviewers and CODEOWNERS)
bb pr create --repo PROJ/repo --from-ref feature/x --to-ref main --title "My change"
# Create a draft pull request (Bitbucket DC 8.0+)
bb pr create --repo PROJ/repo --from-ref feature/x --to-ref main --title "My change" --draft
# Create a pull request and assign explicit reviewers (repeatable or comma-separated)
bb pr create --repo PROJ/repo --from-ref feature/x --to-ref main --title "My change" --reviewers alice,bob
# Create a pull request with reviewers and reviewer groups
bb pr create --repo PROJ/repo --from-ref feature/x --to-ref main --title "My change" --reviewers alice,@backend-team --reviewer-group qa-team
# Create a pull request without default reviewers or CODEOWNERS
bb pr create --repo PROJ/repo --from-ref feature/x --to-ref main --title "My change" --no-default-reviewers --no-codeowners
Flags:
--codeowners Assign the code owners Bitbucket reports for the change, the same ones the web interface offers; the CODEOWNERS syntax and its meaning are the server's (default true)
--default-reviewers Include default reviewers configured on repository/project; a failed lookup warns, unless this flag is passed explicitly, which makes it fatal (default true)
--description string Pull request description
--draft Create as a draft pull request (Bitbucket DC 8.0+)
--from-ref string Source branch (name or refs/heads/name)
--from-repo string Repository holding --from-ref as PROJECT/slug, for a fork to upstream pull request (defaults to --repo)
--no-codeowners Do not assign code owners
--no-default-reviewers Do not include default reviewers
--reviewer-group strings Reviewer group name(s) to expand and add (repeatable or comma-separated; a leading @ and a reviewer-group/ prefix are both accepted; alias --reviewer-groups)
--reviewers strings Reviewer usernames to add (repeatable or comma-separated, accepts @group syntax, e.g. --reviewers alice,@backend-team)
--title string Pull request title
--to-ref string Target branch (name or refs/heads/name)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr decline¶
Decline a pull request
Decline a pull request
Usage:
bb pr decline <id> [flags]
Aliases:
decline, close
Flags:
--version int Expected pull request version; omit to act on whatever version is current
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr default-reviewers¶
List default reviewers and matching conditions for repository
List default reviewers and matching conditions for repository
Usage:
bb pr default-reviewers [flags]
Flags:
--source-ref string The ID of the source ref (e.g. refs/heads/feature)
--source-repo-id string The ID of the repository in which the source ref exists
--target-ref string The ID of the target ref (e.g. refs/heads/master)
--target-repo-id string The ID of the repository in which the target ref exists
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr diff¶
Diff a pull request (alias for bb diff pr)
Diff a pull request.
Alias for bb diff pr, which is where the command reference documents it.
Usage:
bb pr diff <id> [flags]
Flags:
--name-only Output only changed file names
--patch Output unified patch stream
--stat Output structured diff stats
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr files¶
List the files changed in a pull request
List the files changed in a pull request
Usage:
bb pr files <id> [flags]
Aliases:
files, changes
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--start int Start offset for the pull request change listing
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr get¶
Get pull request details, including outstanding review feedback
Get pull request details. The output carries a review summary describing unresolved comment threads, open tasks and reviewers who requested changes, so outstanding feedback is visible without a separate lookup.
The unresolved thread counts come from the activity timeline, which is paged through; pass --no-review-summary to skip it. When the timeline is unavailable the summary falls back to the blocker-comment tally, then to the counters Bitbucket ships with the pull request. reviewSummary.countsSource reports which was used.
Usage:
bb pr get <id> [flags]
Aliases:
get, view
Flags:
--no-review-summary Skip the paged activity timeline walk; the summary still carries the open task tally, which costs one request
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr jira¶
List Jira issues associated with a pull request
List Jira issues associated with a pull request
Usage:
bb pr jira <id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr list¶
List pull requests
List pull requests. Each entry carries the open task and comment counters Bitbucket reports with the pull request, so pull requests with outstanding feedback stand out. Pass --with-review-status to additionally resolve unresolved comment threads per pull request. That walks each pull request activity timeline, so it is markedly slower on a long listing.
Usage:
bb pr list [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--source-branch string Optional source branch filter
--start int Start offset for Bitbucket pull request list operations
--state string Pull request state filter (one of: open, closed, all) (default "open")
--target-branch string Optional target branch filter
--with-review-status Resolve unresolved comment threads per pull request (walks each activity timeline; slower)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr merge¶
Merge a pull request
Merge a pull request
Usage:
bb pr merge <id> [flags]
Flags:
--version int Expected pull request version; omit to act on whatever version is current
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr merge-base¶
Show the common ancestor commit of a pull request's source and target branches
Show the common ancestor commit of a pull request's source and target branches
Usage:
bb pr merge-base <id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr participants¶
Search pull request participants across a repository
Search pull request participants across a repository
Usage:
bb pr participants [flags]
Flags:
--search string Query filter (checks username, name, or email)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr ready¶
Mark a draft pull request ready for review, or turn it back into a draft
Mark a draft pull request ready for review. With --undo, turn an open pull request back into a draft.
bb reads the pull request's current version itself. If the pull request changes between that read and the update, so that Bitbucket refuses the version as out of date, bb reads it again and retries once.
A pull request already in the requested state is left as it is, and the command succeeds saying nothing changed. A merged or declined pull request is refused: only an open one can be marked ready or turned into a draft.
bb pr update --draft sets the same flag alongside other fields, and takes --version for a caller who wants the change refused if the pull request has moved on since they read it.
Usage:
bb pr ready <id> [flags]
Examples:
# Mark a draft pull request ready for review
bb pr ready 42 --repo PROJ/repo
# Turn it back into a draft
bb pr ready 42 --repo PROJ/repo --undo
Flags:
--undo Turn the pull request back into a draft instead
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr rebase¶
Rebase a pull request
Rebase a pull request
Usage:
bb pr rebase <id> [flags]
Flags:
--version int Expected pull request version
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr reopen¶
Reopen a pull request
Reopen a pull request
Usage:
bb pr reopen <id> [flags]
Flags:
--version int Expected pull request version; omit to act on whatever version is current
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr review¶
Pull request review commands
Pull request review commands
Usage:
bb pr review [command]
Available Commands:
approve Approve a pull request
complete Publish draft comments and optionally submit a status change
discard Discard all draft comments and cancel review
get Retrieve current draft review details
reviewer Manage pull request reviewers
set Set your review status on a pull request
unapprove Clear your review status on a pull request
Use "bb pr review [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr review approve¶
Approve a pull request
Approve a pull request.
Shorthand for `bb pr review set <id> APPROVED`. A participant holds one
status, so approving replaces a request for changes rather than joining it.
Usage:
bb pr review approve <id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr review complete¶
Publish draft comments and optionally submit a status change
Publish your draft review on a pull request: the comments you added with
`bb pr comment add --pending`, together with the status and summary comment
given by --status and --comment.
Bitbucket completes only a review that was started, so this needs at least one
draft comment. Without one it fails and changes nothing. To set a status on its
own, use `bb pr review set`; to post a comment on its own, use `bb pr comment add`.
Usage:
bb pr review complete <id> [flags]
Examples:
# Publish your draft comments
bb pr review complete 42
# Publish them with a request for changes and a summary comment
bb pr review complete 42 --status NEEDS_WORK --comment "Unit tests fail"
Flags:
--comment string Review completion comment text
--status string Pull request status change (one of: APPROVED, NEEDS_WORK, UNAPPROVED)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr review discard¶
Discard all draft comments and cancel review
Discard all draft comments and cancel review
Usage:
bb pr review discard <id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr review get¶
Retrieve current draft review details
Retrieve current draft review details
Usage:
bb pr review get <id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr review reviewer¶
Manage pull request reviewers
Manage pull request reviewers
Usage:
bb pr review reviewer [command]
Available Commands:
add Add reviewers to a pull request
remove Remove a reviewer
Use "bb pr review reviewer [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr review reviewer add¶
Add reviewers to a pull request
Add reviewers to a pull request
Usage:
bb pr review reviewer add <id> [flags]
Examples:
# Add a single reviewer
bb pr review reviewer add 42 --repo PROJ/repo --user alice
# Add multiple reviewers (repeatable or comma-separated)
bb pr review reviewer add 42 --repo PROJ/repo --user alice --user bob
bb pr review reviewer add 42 --repo PROJ/repo --users alice,bob
# Add a reviewer group
bb pr review reviewer add 42 --repo PROJ/repo --reviewer-group core-team
bb pr review reviewer add 42 --repo PROJ/repo --user @core-team
# Add default reviewers configured on repository/project
bb pr review reviewer add 42 --repo PROJ/repo --default-reviewers
# Add reviewers matching .bitbucket/CODEOWNERS
bb pr review reviewer add 42 --repo PROJ/repo --codeowners
Flags:
--codeowners Assign the code owners Bitbucket reports for the change, the same ones the web interface offers; the CODEOWNERS syntax and its meaning are the server's
--default-reviewers Assign default reviewers configured on repository/project for this pull request
--reviewer-group strings Reviewer group name(s) to expand and add (repeatable or comma-separated; a leading @ and a reviewer-group/ prefix are both accepted; alias --reviewer-groups)
--user strings Reviewer username(s) (repeatable or comma-separated, accepts @group syntax; aliases --users, --reviewers)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr review reviewer remove¶
Remove a reviewer
Remove a reviewer
Usage:
bb pr review reviewer remove <id> [flags]
Flags:
--user string Reviewer username
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr review set¶
Set your review status on a pull request
Set your review status on a pull request.
A participant holds exactly one status. APPROVED and NEEDS_WORK are mutually
exclusive, and UNAPPROVED is neither: requesting changes replaces an approval
rather than joining it, and vice versa. Setting the status you already hold is
a no-op.
`approve` and `unapprove` are shorthands for two of these three values.
`unapprove` clears whichever status you hold, so it withdraws a request for
changes as readily as an approval, which its name does not suggest.
Usage:
bb pr review set <id> <status> [flags]
Examples:
# Request changes
bb pr review set 42 NEEDS_WORK
# Approve
bb pr review set 42 APPROVED
# Withdraw whichever status you hold
bb pr review set 42 UNAPPROVED
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr review unapprove¶
Clear your review status on a pull request
Clear your review status on a pull request.
Shorthand for `bb pr review set <id> UNAPPROVED`, and it does more than the
name suggests: a participant holds one status, so this clears a request for
changes as readily as an approval. There is no separate verb for withdrawing
NEEDS_WORK.
Usage:
bb pr review unapprove <id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr status¶
Show pull requests waiting on you
Show pull requests waiting on you, in three sections: the pull requests for the current branch, the ones you opened, and the ones asking for your review.
The last two are cross-repository and need no repository context. The current-branch section needs a git checkout with a Bitbucket remote, and is reported as unavailable rather than as an error when there is not one.
Usage:
bb pr status [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr unwatch¶
Unwatch a pull request
Unwatch a pull request
Usage:
bb pr unwatch <id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr update¶
Update pull request metadata
Update a pull request's title, description, draft state or reviewers.
Bitbucket refuses an update carrying a version the pull request has moved on from, rather than overwriting someone else's change. bb reads that version, so --version is only needed to assert a particular one: pass it and a pull request that has changed since is reported instead of updated.
To mark a draft ready for review, or turn a pull request back into a draft, use bb pr ready.
Usage:
bb pr update <id> [flags]
Aliases:
update, edit
Examples:
# Update title and description
bb pr update 42 --repo PROJ/repo --title "New title"
# Mark a draft PR as ready for review
bb pr update 42 --repo PROJ/repo --draft=false
# Refuse the update if the pull request has changed since version 1
bb pr update 42 --repo PROJ/repo --version 1 --draft
Flags:
--description string Updated pull request description
--draft Set draft state: --draft to mark as draft, --draft=false to mark as ready for review
--reviewers strings Replace the reviewers (repeatable or comma-separated, accepts @group syntax); omit to keep the current reviewers, pass "" to clear them
--title string Updated pull request title
--version int Expected pull request version; omit to act on whatever version is current
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb pr watch¶
Watch a pull request
Watch a pull request
Usage:
bb pr watch <id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project¶
Project administration commands
Project administration commands
Usage:
bb project [command]
Available Commands:
branch-restriction Manage project branch restrictions
create Create a new project
default-task Manage project default checklist tasks
delete Delete a project
get Get project details
list List projects
permissions Project permissions
update Update project details
webhook Manage project webhooks
Use "bb project [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project branch-restriction¶
Manage project branch restrictions
Manage project branch restrictions
Usage:
bb project branch-restriction [command]
Available Commands:
create Create a new project-level restriction
delete Delete a project restriction
get Get details of a single branch restriction
list List all project branch restrictions
update Update an existing restriction
Use "bb project branch-restriction [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project branch-restriction create¶
Create a new project-level restriction
Create a new project-level restriction
Usage:
bb project branch-restriction create <project-key> [flags]
Flags:
--access-key-id ints Allowed SSH access key IDs
--group strings Allowed group names
--matcher-display string Matcher display value
--matcher-id string Matcher id value
--matcher-type string Matcher type (one of: BRANCH, MODEL_BRANCH, MODEL_CATEGORY, PATTERN) (default "BRANCH")
--type string Restriction type (one of: read-only, no-deletes, fast-forward-only, pull-request-only, no-creates)
--user strings Allowed user slugs
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project branch-restriction delete¶
Delete a project restriction
Delete a project restriction
Usage:
bb project branch-restriction delete <project-key> <restriction-id> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project branch-restriction get¶
Get details of a single branch restriction
Get details of a single branch restriction
Usage:
bb project branch-restriction get <project-key> <restriction-id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project branch-restriction list¶
List all project branch restrictions
List all project branch restrictions
Usage:
bb project branch-restriction list <project-key> [flags]
Flags:
--matcher-id string Filter by matcher ID value
--matcher-type string Filter by matcher type (one of: BRANCH, MODEL_BRANCH, MODEL_CATEGORY, PATTERN)
--type string Filter by restriction type (one of: read-only, no-deletes, fast-forward-only, pull-request-only, no-creates)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project branch-restriction update¶
Update an existing restriction
Update an existing restriction
Usage:
bb project branch-restriction update <project-key> <restriction-id> [flags]
Flags:
--access-key-id ints Allowed SSH access key IDs
--group strings Allowed group names
--matcher-display string Matcher display value
--matcher-id string Matcher id value
--matcher-type string Matcher type (one of: BRANCH, MODEL_BRANCH, MODEL_CATEGORY, PATTERN)
--type string Restriction type (one of: read-only, no-deletes, fast-forward-only, pull-request-only, no-creates)
--user strings Allowed user slugs
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project create¶
Create a new project
Create a new project
Usage:
bb project create <key> [flags]
Flags:
--description string Project description
--name string Project name (required)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project default-task¶
Manage project default checklist tasks
Manage project default checklist tasks
Usage:
bb project default-task [command]
Available Commands:
add Add a default checklist task
delete Delete a default checklist task
list List all default checklist tasks for the project
update Update a default checklist task
Use "bb project default-task [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project default-task add¶
Add a default checklist task
Add a default checklist task
Usage:
bb project default-task add <project-key> <description> [flags]
Flags:
--source-ref string Source ref to match; a glob matches as a pattern, anything else as a branch (default: any ref)
--target-ref string Target ref to match; a glob matches as a pattern, anything else as a branch (default: any ref)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project default-task delete¶
Delete a default checklist task
Delete a default checklist task
Usage:
bb project default-task delete <project-key> <task-id> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project default-task list¶
List all default checklist tasks for the project
List all default checklist tasks for the project
Usage:
bb project default-task list <project-key> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project default-task update¶
Update a default checklist task
Update a default checklist task
Usage:
bb project default-task update <project-key> <task-id> [flags]
Flags:
--description string New task description
--source-ref string New source ref to match; a glob matches as a pattern, anything else as a branch (default: any ref)
--target-ref string New target ref to match; a glob matches as a pattern, anything else as a branch (default: any ref)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project delete¶
Delete a project
Delete a project
Usage:
bb project delete <key> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project get¶
Get project details
Get project details
Usage:
bb project get <key> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project list¶
List projects
List projects
Usage:
bb project list [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--name string Filter projects by name
--start int Start offset for list operations
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project permissions¶
Project permissions
Project permissions
Usage:
bb project permissions [command]
Available Commands:
grant Grant a project permission to a user or group
groups Group permissions
list List users or groups with project permissions
revoke Revoke a project permission from a user or group
show Show the caller's effective permissions on a project
users User permissions
Use "bb project permissions [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project permissions grant¶
Grant a project permission to a user or group
Grant a project permission to a user, or to a group with --group.
Shallow alias for bb project permissions {users,groups} grant.
Usage:
bb project permissions grant <key> <user-or-group> <permission> [flags]
Flags:
--group Treat the argument as a group rather than a user
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project permissions groups¶
Group permissions
Group permissions
Usage:
bb project permissions groups [command]
Available Commands:
grant Grant a project permission to a group
list List groups with project permissions
revoke Revoke a project permission from a group
Use "bb project permissions groups [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project permissions groups grant¶
Grant a project permission to a group
Grant a project permission to a group.
Also available as bb project permissions grant --group, one level shallower.
Usage:
bb project permissions groups grant <key> <group> <permission> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project permissions groups list¶
List groups with project permissions
List groups with project permissions.
Also available as bb project permissions list --group, one level shallower.
Usage:
bb project permissions groups list <key> [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 100)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project permissions groups revoke¶
Revoke a project permission from a group
Revoke a project permission from a group.
Also available as bb project permissions revoke --group, one level shallower.
Usage:
bb project permissions groups revoke <key> <group> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project permissions list¶
List users or groups with project permissions
List users with project permissions, or groups with --group.
Shallow alias for bb project permissions {users,groups} list.
Usage:
bb project permissions list <key> [flags]
Flags:
--all Return every result rather than the first --limit
--group List groups instead of users
--limit int Maximum number of results to return (default 100)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project permissions revoke¶
Revoke a project permission from a user or group
Revoke a project permission from a user, or from a group with --group.
Shallow alias for bb project permissions {users,groups} revoke.
Usage:
bb project permissions revoke <key> <user-or-group> [flags]
Flags:
--group Treat the argument as a group rather than a user
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project permissions show¶
Show the caller's effective permissions on a project
Show the caller's effective permissions on a project
Usage:
bb project permissions show <key> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project permissions users¶
User permissions
User permissions
Usage:
bb project permissions users [command]
Available Commands:
grant Grant a project permission to a user
list List users with project permissions
revoke Revoke a project permission from a user
Use "bb project permissions users [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project permissions users grant¶
Grant a project permission to a user
Grant a project permission to a user.
Also available as bb project permissions grant, one level shallower.
Usage:
bb project permissions users grant <key> <username> <permission> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project permissions users list¶
List users with project permissions
List users with project permissions.
Also available as bb project permissions list, one level shallower.
Usage:
bb project permissions users list <key> [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 100)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project permissions users revoke¶
Revoke a project permission from a user
Revoke a project permission from a user.
Also available as bb project permissions revoke, one level shallower.
Usage:
bb project permissions users revoke <key> <username> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project update¶
Update project details
Update project details
Usage:
bb project update <key> [flags]
Flags:
--description string Project description
--name string Project name
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project webhook¶
Manage project webhooks
Manage project webhooks
Usage:
bb project webhook [command]
Available Commands:
create Create a new project-level webhook
delete Delete a project webhook
list List all webhooks configured for the project
stats Retrieve execution statistics
test Trigger a connection test ping
update Update a project webhook
Use "bb project webhook [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project webhook create¶
Create a new project-level webhook
Create a new project-level webhook
Usage:
bb project webhook create <project-key> <name> <url> [flags]
Flags:
--active Whether the webhook is active (default true)
--credentials-password-stdin Read the endpoint password from stdin (or set BB_WEBHOOK_PASSWORD)
--credentials-username string Username Bitbucket authenticates to the endpoint with
--event strings Webhook events to subscribe to (default [repo:refs_changed])
--secret-stdin Read the shared secret from stdin (or set BB_WEBHOOK_SECRET)
--ssl-verification string Whether Bitbucket verifies the endpoint's TLS certificate, left as the server has it when omitted (one of: true, false)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project webhook delete¶
Delete a project webhook
Delete a project webhook
Usage:
bb project webhook delete <project-key> <webhook-id> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project webhook list¶
List all webhooks configured for the project
List all webhooks configured for the project
Usage:
bb project webhook list <project-key> [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--start int Start index for webhooks listing
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project webhook stats¶
Retrieve execution statistics
Retrieve execution statistics
Usage:
bb project webhook stats <project-key> <webhook-id> [flags]
Flags:
--summary Get statistics summary instead of detailed logs
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project webhook test¶
Trigger a connection test ping
Trigger a connection test ping
Usage:
bb project webhook test <project-key> <webhook-id> [flags]
Flags:
--reveal-secret Print the endpoint credentials Bitbucket sent instead of redacting it
--url string Test this URL instead of the webhook's configured one
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb project webhook update¶
Update a project webhook
Update a project webhook
Usage:
bb project webhook update <project-key> <webhook-id> [flags]
Flags:
--active string Active status (one of: true, false)
--credentials-password-stdin Read the endpoint password from stdin (or set BB_WEBHOOK_PASSWORD)
--credentials-username string Username Bitbucket authenticates to the endpoint with
--event strings New list of webhook events
--name string New name
--no-credentials Remove the endpoint credentials from the webhook
--no-secret Remove the shared secret from the webhook
--secret-stdin Read the shared secret from stdin (or set BB_WEBHOOK_SECRET)
--ssl-verification string Whether Bitbucket verifies the endpoint's TLS certificate, left as the server has it when omitted (one of: true, false)
--url string New URL
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ref¶
Repository ref resolution and listing commands
Repository ref resolution and listing commands
Usage:
bb ref [command]
Available Commands:
list List repository refs (branches and tags)
resolve Resolve a ref by name to its full ref and commit if applicable
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb ref [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ref list¶
List repository refs (branches and tags)
List repository refs (branches and tags)
Usage:
bb ref list [flags]
Flags:
--filter string Filter refs by name
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ref resolve¶
Resolve a ref by name to its full ref and commit if applicable
Resolve a ref by name to its full ref and commit if applicable
Usage:
bb ref resolve <name> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo¶
Repository commands
Repository commands
Usage:
bb repo [command]
Available Commands:
admin Repository administration commands (create/fork/update/delete)
archive Download repository archive
browse Repository content browsing commands
cat Output the raw content of a file over REST
clone Clone a repository to the local filesystem
comment Comment commands for commits and pull requests
compare Compare commits or branches
create Create a new repository
default-task Manage repository default checklist tasks
delete Delete a repository
edit Edit a file's content over REST
fork Fork a repository
get Show a repository's details and its README
label Manage repository labels
list List repositories
permissions Repository permission inspection commands
settings Repository settings commands
ssh-key Manage project or repository SSH access keys
sync Manage repository fork synchronization
unwatch Unwatch repository
watch Watch repository
Use "bb repo [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo admin¶
Repository administration commands (create/fork/update/delete)
Repository administration commands (create/fork/update/delete)
Usage:
bb repo admin [command]
Available Commands:
create Create a new repository
delete Delete a repository
fork Fork a repository
update Update repository metadata
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb repo admin [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo admin create¶
Create a new repository
Create a new repository.
Alias for bb repo create.
Usage:
bb repo admin create [flags]
Flags:
--default-branch string Repository default branch
--description string Repository description
--forkable Repository forkable (default true)
--name string Repository name
--project string Project key
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo admin delete¶
Delete a repository
Delete a repository.
Alias for bb repo delete.
Usage:
bb repo admin delete [PROJECT/slug] [flags]
Flags:
--yes Skip the confirmation. Only applies when the repository is named explicitly.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo admin fork¶
Fork a repository
Fork a repository.
Alias for bb repo fork.
Usage:
bb repo admin fork [flags]
Flags:
--name string Name of the new fork
--project string Project key of the new fork
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo admin update¶
Update repository metadata
Update repository metadata
Usage:
bb repo admin update [flags]
Flags:
--default-branch string Repository default branch
--description string Repository description
--name string Repository name
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo archive¶
Download repository archive
Download repository archive
Usage:
bb repo archive [flags]
Flags:
--at string The commit to stream an archive of
--format string The format to stream the archive in (one of: zip, tar, tar.gz, tgz) (default "zip")
-o, --output string Output filename (use '-' for stdout, defaults to <repo-slug>.<format>)
--path string Paths to include in the streamed archive
--prefix string A prefix to apply to all entries in the streamed archive
--repo string Repository as PROJECT/slug
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo browse¶
Repository content browsing commands
Repository content browsing commands
Usage:
bb repo browse [command]
Available Commands:
blame Get file blame
file Get structured file content
history List commit history for a file
raw Get raw file content
tree List repository files in a directory
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb repo browse [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo browse blame¶
Get file blame
Get file blame
Usage:
bb repo browse blame <path> [flags]
Flags:
--at string Commit ID or ref
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo browse file¶
Get structured file content
Get structured file content
Usage:
bb repo browse file <path> [flags]
Flags:
--at string Commit ID or ref
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo browse history¶
List commit history for a file
List commit history for a file
Usage:
bb repo browse history <path> [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo browse raw¶
Get raw file content
Get raw file content
Usage:
bb repo browse raw <path> [flags]
Flags:
--at string Commit ID or ref
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo browse tree¶
List repository files in a directory
List repository files in a directory
Usage:
bb repo browse tree [path] [flags]
Flags:
--all Return every result rather than the first --limit
--at string Commit ID or ref to browse
--limit int Maximum number of results to return (default 1000)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo cat¶
Output the raw content of a file over REST
Output the raw content of a file over REST
Usage:
bb repo cat <path> [flags]
Flags:
--at string Commit ID or ref to cat
--repo string Repository as PROJECT/slug
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo clone¶
Clone a repository to the local filesystem
Clone a repository to the local filesystem
Usage:
bb repo clone <repository> [directory] [-- <gitflags>...] [flags]
Flags:
--https Use HTTPS only and skip the SSH clone attempt
--no-upstream Do not add an upstream remote when cloning a fork
--ssh Use SSH only and disable HTTPS fallback
-u, --upstream-remote-name string Upstream remote name when cloning a fork (default "upstream")
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo comment¶
Comment commands for commits and pull requests
Comment commands for commits and pull requests
Usage:
bb repo comment [command]
Available Commands:
create Create a comment
delete Delete a comment
list List comments
update Update a comment
Flags:
--commit string Commit ID context
--pr string Pull request ID context
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb repo comment [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo comment create¶
Create a comment
Create a comment on a commit or a pull request.
Pass --parent to reply to an existing comment rather than start a new thread. The id to pass is the one `bb repo comment list` reports; a reply carries reply and parentId in that listing, so a thread can be walked back to its root.
Usage:
bb repo comment create [flags]
Flags:
--line int Line within --path to anchor the comment to
--line-type string Which side of the diff --line refers to (one of: ADDED, REMOVED, CONTEXT)
--parent int Reply to this comment id instead of starting a new thread
--path string Anchor the comment to this file, which is what makes it listable
--text string Comment text
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--commit string Commit ID context
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--pr string Pull request ID context
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo comment delete¶
Delete a comment
Delete a comment
Usage:
bb repo comment delete [flags]
Flags:
--id string Comment ID
--version int32 Expected comment version
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--commit string Commit ID context
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--pr string Pull request ID context
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo comment list¶
List comments
List comments
Usage:
bb repo comment list [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--path string File path to scope the listing to. Bitbucket requires it: a comment anchored to no file cannot be listed.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--commit string Commit ID context
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--pr string Pull request ID context
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo comment update¶
Update a comment
Update a comment
Usage:
bb repo comment update [flags]
Flags:
--id string Comment ID
--text string Comment text
--version int32 Expected comment version
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--commit string Commit ID context
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--pr string Pull request ID context
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo compare¶
Compare commits or branches
Compare commits or branches: what is reachable from <from> but not from
<to>. Pass the ref you are asking about first; git log's range puts it last.
bb repo compare feature/x main # what feature/x adds
bb repo compare main feature/x # nothing, unless main has moved
Usage:
bb repo compare <from> <to> [flags]
Flags:
--diff Show the unified diff of the changes
--repo string Repository as PROJECT/slug
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo create¶
Create a new repository
Create a new repository.
Also available as bb repo admin create.
Usage:
bb repo create [flags]
Flags:
--default-branch string Repository default branch
--description string Repository description
--forkable Repository forkable (default true)
--name string Repository name
--project string Project key
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo default-task¶
Manage repository default checklist tasks
Manage repository default checklist tasks
Usage:
bb repo default-task [command]
Available Commands:
add Add a default checklist task
delete Delete a default checklist task
list List default checklist tasks
update Update a default checklist task
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb repo default-task [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo default-task add¶
Add a default checklist task
Add a default checklist task
Usage:
bb repo default-task add <description> [flags]
Flags:
--source-ref string Source ref to match; a glob matches as a pattern, anything else as a branch (default: any ref)
--target-ref string Target ref to match; a glob matches as a pattern, anything else as a branch (default: any ref)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo default-task delete¶
Delete a default checklist task
Delete a default checklist task
Usage:
bb repo default-task delete <id> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo default-task list¶
List default checklist tasks
List default checklist tasks
Usage:
bb repo default-task list [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo default-task update¶
Update a default checklist task
Update a default checklist task
Usage:
bb repo default-task update <id> [flags]
Flags:
--description string New task description
--source-ref string New source ref to match; a glob matches as a pattern, anything else as a branch (default: any ref)
--target-ref string New target ref to match; a glob matches as a pattern, anything else as a branch (default: any ref)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo delete¶
Delete a repository
Delete a repository.
Name the repository as a PROJECT/slug argument or with --repo. Without one it is
inferred from the git remote, and --yes does not apply to an inferred target:
a safety flag that works on a target you did not name is not one. At a terminal
the confirmation names what will be deleted.
Also available as bb repo admin delete.
Usage:
bb repo delete [PROJECT/slug] [flags]
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--yes Skip the confirmation. Only applies when the repository is named explicitly.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo edit¶
Edit a file's content over REST
Edit a file's content over REST
Usage:
bb repo edit <path> [flags]
Flags:
--branch string The branch on which the file should be modified or created
--content string The full content of the file
--message string Commit message
--repo string Repository as PROJECT/slug
--source-branch string Starting point branch
--source-commit string Commit ID before editing
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo fork¶
Fork a repository
Fork a repository.
Also available as bb repo admin fork.
Usage:
bb repo fork [flags]
Flags:
--name string Name of the new fork
--project string Project key of the new fork
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo get¶
Show a repository's details and its README
Show a repository's description, state and clone URLs, followed by its README.
The README is the file Bitbucket picks from the default branch, printed as raw markup: bb does not render it. A repository without a README says so rather than failing. --readme=false leaves the README out and skips the request for it.
bb repo view is the gh spelling of the same command. To open the repository in a browser, use bb browse.
Usage:
bb repo get [flags]
Aliases:
get, view
Examples:
# Describe a repository and print its README
bb repo get --repo PROJ/repo
# Only the details
bb repo get --repo PROJ/repo --readme=false
Flags:
--readme Include the README; --readme=false leaves it out (default true)
--repo string Repository as PROJECT/slug
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo label¶
Manage repository labels
Manage repository labels
Usage:
bb repo label [command]
Available Commands:
add Add a repository label
list List repository labels
remove Remove a repository label
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb repo label [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo label add¶
Add a repository label
Add a repository label
Usage:
bb repo label add <label> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo label list¶
List repository labels
List repository labels
Usage:
bb repo label list [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo label remove¶
Remove a repository label
Remove a repository label
Usage:
bb repo label remove <label> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo list¶
List repositories
List repositories
Usage:
bb repo list [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--project string Filter by project key
--start int Start offset for list operations
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo permissions¶
Repository permission inspection commands
Repository permission inspection commands
Usage:
bb repo permissions [command]
Available Commands:
grant Grant a repository permission to a user or group
list List users or groups with repository permissions
revoke Revoke a repository permission from a user or group
show Show the caller's effective permissions on a repository
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb repo permissions [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo permissions grant¶
Grant a repository permission to a user or group
Grant a repository permission to a user, or to a group with --group.
Shallow alias for bb repo settings security permissions {users,groups} grant.
Usage:
bb repo permissions grant <user-or-group> <permission> [flags]
Flags:
--group Treat the argument as a group rather than a user
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo permissions list¶
List users or groups with repository permissions
List users with repository permissions, or groups with --group.
Shallow alias for bb repo settings security permissions {users,groups} list.
Usage:
bb repo permissions list [flags]
Flags:
--all Return every result rather than the first --limit
--group List groups instead of users
--limit int Maximum number of results to return (default 100)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo permissions revoke¶
Revoke a repository permission from a user or group
Revoke a repository permission from a user, or from a group with --group.
Shallow alias for bb repo settings security permissions {users,groups} revoke.
Usage:
bb repo permissions revoke <user-or-group> [flags]
Flags:
--group Treat the argument as a group rather than a user
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo permissions show¶
Show the caller's effective permissions on a repository
Show the caller's effective permissions on a repository
Usage:
bb repo permissions show [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings¶
Repository settings commands
Repository settings commands
Usage:
bb repo settings [command]
Available Commands:
auto-decline Manage repository auto-decline settings
auto-merge Manage repository auto-merge settings
pull-requests Pull request settings
security Security settings
workflow Workflow settings
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb repo settings [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings auto-decline¶
Manage repository auto-decline settings
Manage repository auto-decline settings
Usage:
bb repo settings auto-decline [command]
Available Commands:
delete Delete repository auto-decline settings
get Get repository auto-decline settings
set Set repository auto-decline settings
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb repo settings auto-decline [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings auto-decline delete¶
Delete repository auto-decline settings
Delete repository auto-decline settings
Usage:
bb repo settings auto-decline delete [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings auto-decline get¶
Get repository auto-decline settings
Get repository auto-decline settings
Usage:
bb repo settings auto-decline get [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings auto-decline set¶
Set repository auto-decline settings
Set repository auto-decline settings
Usage:
bb repo settings auto-decline set [flags]
Flags:
--enabled Enable or disable auto-decline
--inactivity-weeks int32 Number of inactivity weeks before auto-decline
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings auto-merge¶
Manage repository auto-merge settings
Manage repository auto-merge settings
Usage:
bb repo settings auto-merge [command]
Available Commands:
delete Delete repository auto-merge settings
get Get repository auto-merge settings
set Set repository auto-merge settings
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb repo settings auto-merge [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings auto-merge delete¶
Delete repository auto-merge settings
Delete repository auto-merge settings
Usage:
bb repo settings auto-merge delete [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings auto-merge get¶
Get repository auto-merge settings
Get repository auto-merge settings
Usage:
bb repo settings auto-merge get [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings auto-merge set¶
Set repository auto-merge settings
Set repository auto-merge settings
Usage:
bb repo settings auto-merge set [flags]
Flags:
--enabled Enable or disable auto-merge
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings pull-requests¶
Pull request settings
Pull request settings
Usage:
bb repo settings pull-requests [command]
Available Commands:
get Get repository pull-request settings
merge-checks Manage repository merge checks
set-strategy Set default merge strategy
update Update repository pull-request settings
update-approvers Update required approvers count
Use "bb repo settings pull-requests [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings pull-requests get¶
Get repository pull-request settings
Get repository pull-request settings
Usage:
bb repo settings pull-requests get [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings pull-requests merge-checks¶
Manage repository merge checks
Manage repository merge checks
Usage:
bb repo settings pull-requests merge-checks [command]
Available Commands:
list List configured merge checks
Use "bb repo settings pull-requests merge-checks [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings pull-requests merge-checks list¶
List configured merge checks
List configured merge checks
Usage:
bb repo settings pull-requests merge-checks list [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings pull-requests set-strategy¶
Set default merge strategy
Set default merge strategy
Usage:
bb repo settings pull-requests set-strategy <strategy-id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings pull-requests update¶
Update repository pull-request settings
Update repository pull-request settings
Usage:
bb repo settings pull-requests update [flags]
Flags:
--required-all-tasks-complete Require all pull-request tasks to be completed before merge
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings pull-requests update-approvers¶
Update required approvers count
Update required approvers count
Usage:
bb repo settings pull-requests update-approvers [flags]
Flags:
--count int Required approvers count (0 disables check)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings security¶
Security settings
Security settings
Usage:
bb repo settings security [command]
Available Commands:
permissions Repository permissions
Use "bb repo settings security [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings security permissions¶
Repository permissions
Repository permissions
Usage:
bb repo settings security permissions [command]
Available Commands:
groups Group permissions
users User permissions
Use "bb repo settings security permissions [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings security permissions groups¶
Group permissions
Group permissions
Usage:
bb repo settings security permissions groups [command]
Available Commands:
grant Grant a repository permission to a group
list List groups with repository permissions
revoke Revoke a repository permission from a group
Use "bb repo settings security permissions groups [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings security permissions groups grant¶
Grant a repository permission to a group
Grant a repository permission to a group.
Also available as bb repo permissions grant --group, one level shallower.
Usage:
bb repo settings security permissions groups grant <group> <permission> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings security permissions groups list¶
List groups with repository permissions
List groups with repository permissions.
Also available as bb repo permissions list --group, one level shallower.
Usage:
bb repo settings security permissions groups list [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 100)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings security permissions groups revoke¶
Revoke a repository permission from a group
Revoke a repository permission from a group.
Also available as bb repo permissions revoke --group, one level shallower.
Usage:
bb repo settings security permissions groups revoke <group> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings security permissions users¶
User permissions
User permissions
Usage:
bb repo settings security permissions users [command]
Available Commands:
grant Grant a repository permission to a user
list List users with repository permissions
revoke Revoke a repository permission from a user
Use "bb repo settings security permissions users [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings security permissions users grant¶
Grant a repository permission to a user
Grant a repository permission to a user.
Also available as bb repo permissions grant, one level shallower.
Usage:
bb repo settings security permissions users grant <username> <permission> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings security permissions users list¶
List users with repository permissions
List users with repository permissions.
Also available as bb repo permissions list, one level shallower.
Usage:
bb repo settings security permissions users list [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 100)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings security permissions users revoke¶
Revoke a repository permission from a user
Revoke a repository permission from a user.
Also available as bb repo permissions revoke, one level shallower.
Usage:
bb repo settings security permissions users revoke <username> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings workflow¶
Workflow settings
Workflow settings
Usage:
bb repo settings workflow [command]
Available Commands:
webhooks Repository webhooks
Use "bb repo settings workflow [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings workflow webhooks¶
Repository webhooks
Repository webhooks
Usage:
bb repo settings workflow webhooks [command]
Available Commands:
create Create a repository webhook
delete Delete a repository webhook
list List repository webhooks
Use "bb repo settings workflow webhooks [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings workflow webhooks create¶
Create a repository webhook
Create a repository webhook
Usage:
bb repo settings workflow webhooks create <name> <url> [flags]
Flags:
--active Whether the webhook is active (default true)
--credentials-password-stdin Read the endpoint password from stdin (or set BB_WEBHOOK_PASSWORD)
--credentials-username string Username Bitbucket authenticates to the endpoint with
--event strings Webhook event(s) to subscribe to (default [repo:refs_changed])
--secret-stdin Read the shared secret from stdin (or set BB_WEBHOOK_SECRET)
--ssl-verification string Whether Bitbucket verifies the endpoint's TLS certificate, left as the server has it when omitted (one of: true, false)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings workflow webhooks delete¶
Delete a repository webhook
Delete a repository webhook
Usage:
bb repo settings workflow webhooks delete <webhook-id> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo settings workflow webhooks list¶
List repository webhooks
List repository webhooks
Usage:
bb repo settings workflow webhooks list [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo ssh-key¶
Manage project or repository SSH access keys
Manage project or repository SSH access keys
Usage:
bb repo ssh-key [command]
Available Commands:
add Add a project or repository SSH access key
list List project or repository SSH access keys
remove Remove a project or repository SSH access key by ID
Flags:
--project string Project key for project-level SSH keys
--repo string Repository reference (projectKey/repositorySlug) for repository-level SSH keys
Use "bb repo ssh-key [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo ssh-key add¶
Add a project or repository SSH access key
Add a project or repository SSH access key
Usage:
bb repo ssh-key add <key-file-or-text> [flags]
Flags:
--label string Label/comment for the SSH key
--permission string Permission level (one of: read-only, read-write) (default "read-only")
--read-only Add as read-only access key
--read-write Add as read-write access key
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key for project-level SSH keys
--repo string Repository reference (projectKey/repositorySlug) for repository-level SSH keys
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo ssh-key list¶
List project or repository SSH access keys
List project or repository SSH access keys
Usage:
bb repo ssh-key list [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key for project-level SSH keys
--repo string Repository reference (projectKey/repositorySlug) for repository-level SSH keys
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo ssh-key remove¶
Remove a project or repository SSH access key by ID
Remove a project or repository SSH access key by ID
Usage:
bb repo ssh-key remove <key-id> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key for project-level SSH keys
--repo string Repository reference (projectKey/repositorySlug) for repository-level SSH keys
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo sync¶
Manage repository fork synchronization
Manage repository fork synchronization
Usage:
bb repo sync [flags]
bb repo sync [command]
Available Commands:
disable Disable automatic background synchronization
enable Enable automatic background synchronization
status Query synchronization status, divergence, and settings
Flags:
--action string How to reconcile the ref (one of: MERGE, DISCARD, REBASE) (default "MERGE")
--ref string Ref to synchronize (defaults to the repository default branch)
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb repo sync [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo sync disable¶
Disable automatic background synchronization
Disable automatic background synchronization
Usage:
bb repo sync disable [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo sync enable¶
Enable automatic background synchronization
Enable automatic background synchronization
Usage:
bb repo sync enable [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo sync status¶
Query synchronization status, divergence, and settings
Query synchronization status, divergence, and settings
Usage:
bb repo sync status [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo unwatch¶
Unwatch repository
Unwatch repository
Usage:
bb repo unwatch [flags]
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb repo watch¶
Watch repository
Watch repository
Usage:
bb repo watch [flags]
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb reviewer¶
Manage default reviewers
Manage default reviewer conditions.
Note on CODEOWNERS: .bitbucket/CODEOWNERS is a git-tracked file rather than a REST resource, so it is managed through repository contents and not by this command. For server-level reviewer rules use default-reviewer conditions (bb reviewer condition) and reviewer groups (bb reviewer-group); bb pr create and bb pr review reviewer add ask Bitbucket which code owners a change has, so they match what the web interface shows.
Usage:
bb reviewer [command]
Available Commands:
condition Manage default reviewer conditions
Flags:
--config-file string JSON file containing condition settings
--project string Project key
--repo string Repository as PROJECT/slug
Use "bb reviewer [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb reviewer condition¶
Manage default reviewer conditions
Manage default reviewer conditions
Usage:
bb reviewer condition [command]
Available Commands:
create Create a default reviewer condition
delete Delete a default reviewer condition
list List default reviewer conditions
update Update a default reviewer condition
Use "bb reviewer condition [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--config-file string JSON file containing condition settings
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key
--repo string Repository as PROJECT/slug
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb reviewer condition create¶
Create a default reviewer condition
Create a default reviewer condition using JSON from argument, file (--config-file), or stdin (-)
Usage:
bb reviewer condition create [json-config] [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--config-file string JSON file containing condition settings
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key
--repo string Repository as PROJECT/slug
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb reviewer condition delete¶
Delete a default reviewer condition
Delete a default reviewer condition
Usage:
bb reviewer condition delete <id> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--config-file string JSON file containing condition settings
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key
--repo string Repository as PROJECT/slug
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb reviewer condition list¶
List default reviewer conditions
List default reviewer conditions
Usage:
bb reviewer condition list [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--config-file string JSON file containing condition settings
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key
--repo string Repository as PROJECT/slug
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb reviewer condition update¶
Update a default reviewer condition
Update a default reviewer condition using JSON from argument, file (--config-file), or stdin (-)
Usage:
bb reviewer condition update <id> [json-config] [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--config-file string JSON file containing condition settings
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key
--repo string Repository as PROJECT/slug
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb reviewer-group¶
Manage reviewer groups
Manage reviewer groups
Usage:
bb reviewer-group [command]
Available Commands:
create Create a reviewer group
delete Delete a reviewer group
list List reviewer groups
update Update a reviewer group
users List users in a repository reviewer group
Flags:
--project string Project key
--repo string Repository as PROJECT/slug
Use "bb reviewer-group [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb reviewer-group create¶
Create a reviewer group
Create a reviewer group
Usage:
bb reviewer-group create <name> [flags]
Flags:
--description string Description of the reviewer group
--users strings Members by username (repeatable or comma-separated); required, because Bitbucket refuses a reviewer group with no members
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key
--repo string Repository as PROJECT/slug
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb reviewer-group delete¶
Delete a reviewer group
Delete a reviewer group
Usage:
bb reviewer-group delete <id> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key
--repo string Repository as PROJECT/slug
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb reviewer-group list¶
List reviewer groups
List reviewer groups
Usage:
bb reviewer-group list [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key
--repo string Repository as PROJECT/slug
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb reviewer-group update¶
Update a reviewer group
Update a reviewer group
Usage:
bb reviewer-group update <id> [flags]
Flags:
--description string New description of the reviewer group
--name string New name of the reviewer group
--users strings Replace the members with these usernames (repeatable or comma-separated); omit to keep the current members
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key
--repo string Repository as PROJECT/slug
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb reviewer-group users¶
List users in a repository reviewer group
List users in a repository reviewer group
Usage:
bb reviewer-group users <id> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--project string Project key
--repo string Repository as PROJECT/slug
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb search¶
Search for repositories, commits, and pull requests
Search for repositories, commits, and pull requests
Usage:
bb search [command]
Available Commands:
commits Search for commits within a repository
prs Search for pull requests globally or within a repository
repos Search for repositories
Use "bb search [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb search commits¶
Search for commits within a repository
Search for commits within a repository
Usage:
bb search commits [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--merges string Filter merge commits (one of: exclude, include, only)
--path string Filter by file path
--repo string Repository as PROJECT/slug (required)
--since string Commit ID or ref to search after (exclusive)
--start int Pagination start index
--until string Commit ID or ref to search before (inclusive)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb search prs¶
Search for pull requests globally or within a repository
Search for pull requests globally or within a repository
Usage:
bb search prs [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--repo string Optional repository as PROJECT/slug to scope search
--role string Filter by role; dashboard only, so it cannot be combined with --repo (one of: author, reviewer, participant)
--start int Pagination start index
--state string Filter by state (one of: open, closed, all) (default "open")
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb search repos¶
Search for repositories
Search for repositories
Usage:
bb search repos [name] [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--project string Filter by project key
--start int Pagination start index
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ssh-key¶
Manage personal SSH keys
Manage personal SSH keys
Usage:
bb ssh-key [command]
Available Commands:
add Add a personal SSH key
list List personal SSH keys
remove Remove a personal SSH key by ID
Use "bb ssh-key [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ssh-key add¶
Add a personal SSH key
Add a personal SSH key
Usage:
bb ssh-key add <key-file-or-text> [flags]
Flags:
--label string Label/comment for the SSH key
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ssh-key list¶
List personal SSH keys
List personal SSH keys
Usage:
bb ssh-key list [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--start int Start index for SSH keys listing
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb ssh-key remove¶
Remove a personal SSH key by ID
Remove a personal SSH key by ID
Usage:
bb ssh-key remove <key-id> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb tag¶
Repository tag lifecycle commands
Repository tag lifecycle commands
Usage:
bb tag [command]
Available Commands:
create Create repository tag
delete Delete repository tag
list List repository tags
view View repository tag
Flags:
--filter string Filter text for tag names
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb tag [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb tag create¶
Create repository tag
Create repository tag
Usage:
bb tag create <name> [flags]
Flags:
--message string Optional annotated tag message
--start-point string Commit ID or ref to tag
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--filter string Filter text for tag names
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb tag delete¶
Delete repository tag
Delete repository tag
Usage:
bb tag delete <name> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--filter string Filter text for tag names
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb tag list¶
List repository tags
List repository tags
Usage:
bb tag list [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--order-by string Tag ordering (one of: ALPHABETICAL, MODIFICATION)
--start int Start offset for list operations
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--filter string Filter text for tag names
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb tag view¶
View repository tag
View repository tag
Usage:
bb tag view <name> [flags]
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--filter string Filter text for tag names
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb update¶
Check for and install the latest bb release
Check for and install the latest bb release
Usage:
bb update [flags]
Flags:
--allow-http Permit a plain-HTTP release mirror; refused when administrative policy sets allow_http_update: false
--base-url string Custom release mirror base URL; https unless --allow-http
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb webhook¶
Manage repository webhooks
Manage repository webhooks
Usage:
bb webhook [command]
Available Commands:
create Create a repository webhook
delete Delete a repository webhook
get Get a repository webhook by ID
list List repository webhooks
stats Get repository webhook statistics
test Test connection to repository webhook URL by sending a ping event
update Update a repository webhook
Flags:
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
Use "bb webhook [command] --help" for more information about a command.
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb webhook create¶
Create a repository webhook
Create a repository webhook
Usage:
bb webhook create <name> <url> [flags]
Flags:
--active Whether the new webhook is active (default true)
--credentials-password-stdin Read the endpoint password from stdin (or set BB_WEBHOOK_PASSWORD)
--credentials-username string Username Bitbucket authenticates to the endpoint with
--event strings Webhook event(s) to subscribe to (default [repo:refs_changed])
--secret-stdin Read the shared secret from stdin (or set BB_WEBHOOK_SECRET)
--ssl-verification string Whether Bitbucket verifies the endpoint's TLS certificate, left as the server has it when omitted (one of: true, false)
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb webhook delete¶
Delete a repository webhook
Delete a repository webhook
Usage:
bb webhook delete <id> [flags]
Flags:
-y, --yes Confirm without being asked
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb webhook get¶
Get a repository webhook by ID
Get a repository webhook by ID
Usage:
bb webhook get <id> [flags]
Flags:
--reveal-secret Print the webhook's shared secret instead of redacting it
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb webhook list¶
List repository webhooks
List repository webhooks
Usage:
bb webhook list [flags]
Flags:
--all Return every result rather than the first --limit
--limit int Maximum number of results to return (default 25)
--start int Start index for webhooks listing
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb webhook stats¶
Get repository webhook statistics
Get repository webhook statistics
Usage:
bb webhook stats <id> [flags]
Flags:
--summary Get statistics summary instead of detailed stats
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb webhook test¶
Test connection to repository webhook URL by sending a ping event
Test connection to repository webhook URL by sending a ping event
Usage:
bb webhook test <id> [flags]
Flags:
--reveal-secret Print the endpoint credentials Bitbucket sent instead of redacting it
--url string Test this URL instead of the webhook's configured one
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)
bb webhook update¶
Update a repository webhook
Update a repository webhook
Usage:
bb webhook update <id> [flags]
Flags:
--active string Active status, unchanged when omitted (one of: true, false)
--credentials-password-stdin Read the endpoint password from stdin (or set BB_WEBHOOK_PASSWORD)
--credentials-username string Username Bitbucket authenticates to the endpoint with
--event strings New list of webhook events to subscribe to
--name string New name of the webhook
--no-credentials Remove the endpoint credentials from the webhook
--no-secret Remove the shared secret from the webhook
--secret-stdin Read the shared secret from stdin (or set BB_WEBHOOK_SECRET)
--ssl-verification string Whether Bitbucket verifies the endpoint's TLS certificate, left as the server has it when omitted (one of: true, false)
--url string New URL of the webhook
Global flags
Global Flags:
--ca-file string Path to PEM CA bundle for TLS trust
--client-cert string Path to PEM client certificate for mTLS
--client-key string Path to PEM client key for mTLS
--describe Print the JSON Schema of the command's --json data payload instead of running it
--dry-run Preview mutations without applying them
--full-error-body Print the whole upstream response body in an error instead of a summary
--insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only)
--json Output as JSON
--log-format string Diagnostics format: text or jsonl
--log-level string Diagnostics verbosity: error, warn, info, debug
--no-color Disable colored output
--no-input Never prompt; fail instead when a value is missing
--repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)
--request-timeout string HTTP request timeout (Go duration, e.g. 20s)
--retry-backoff string Base retry backoff duration (e.g. 250ms)
--retry-count int HTTP retry attempts for transient errors (default -1)