Reviewers

Manage pull request reviewers.

Global options available on all PR commands: --json, --no-color, -w, --workspace, -r, --repo.

Identifying users

Bitbucket Cloud no longer accepts the legacy username (login name) when modifying reviewers. The <user> positional accepts either:

An account ID, e.g. 712020:3cfed7e0-0ed6-49fc-bb35-410a00ccee6f
A UUID wrapped in braces, e.g. {c1cb1bb5-2e32-456e-a373-43978dc12aa1}

Both forms are returned by bb pr reviewers list --json (the account_id and uuid fields), so you can pipe the output of one command into another to script reviewer changes. See bb pr create for matching --reviewer examples.

`bb pr reviewers`

Subcommands

Subcommand	Description
`list <id>`	List reviewers on a pull request
`add <id> <user>`	Add a reviewer to a pull request
`remove <id> <user>`	Remove a reviewer from a pull request

`bb pr reviewers list`

List reviewers assigned to a pull request.

bb pr reviewers list <id>

Arguments

Argument	Description
`id`	Pull request ID

Options

Option	Description
`-w, --workspace <workspace>`	Workspace
`-r, --repo <repo>`	Repository
`--json`	Output as JSON

Examples

# List reviewers on PR #42
bb pr reviewers list 42

# List reviewers in specific repository
bb pr reviewers list 42 -w myworkspace -r myrepo

# Get reviewers as JSON for scripting
bb pr reviewers list 42 --json

Notes

Displays reviewers in a table with display name and account ID
Shows a message if no reviewers are assigned
Due to Bitbucket Cloud GDPR changes, the deprecated username field is not displayed

`bb pr reviewers add`

Add a reviewer to a pull request by account ID or UUID. The legacy username (login name) is not accepted by Bitbucket Cloud — see Identifying users.

bb pr reviewers add <id> <user>

Arguments

Argument	Description
`id`	Pull request ID
`user`	Account ID (e.g. `712020:3cfed7e0-…`) or UUID (`{c1cb1bb5-…}`) of the user to add

Options

Option	Description
`-w, --workspace <workspace>`	Workspace
`-r, --repo <repo>`	Repository
`--json`	Output as JSON

Examples

# Add reviewer by account ID
bb pr reviewers add 42 "712020:3cfed7e0-0ed6-49fc-bb35-410a00ccee6f"

# Add reviewer by UUID (note the braces)
bb pr reviewers add 42 "{c1cb1bb5-2e32-456e-a373-43978dc12aa1}"

# Add reviewer in specific repository
bb pr reviewers add 42 "712020:3cfed7e0-0ed6-49fc-bb35-410a00ccee6f" -w myworkspace -r myrepo

# Add reviewer and get result as JSON
bb pr reviewers add 42 "712020:3cfed7e0-0ed6-49fc-bb35-410a00ccee6f" --json

Notes

The user must exist in Bitbucket; you’ll get a clear error message if the user is not found
If the user is already a reviewer, the command succeeds without making changes
Uses UUID for identification (GDPR-compliant)

`bb pr reviewers remove`

Remove a reviewer from a pull request by account ID or UUID. The legacy username (login name) is not accepted by Bitbucket Cloud — see Identifying users.

bb pr reviewers remove <id> <user>

Arguments

Argument	Description
`id`	Pull request ID
`user`	Account ID (e.g. `712020:3cfed7e0-…`) or UUID (`{c1cb1bb5-…}`) of the reviewer to remove

Options

Option	Description
`-w, --workspace <workspace>`	Workspace
`-r, --repo <repo>`	Repository
`--json`	Output as JSON

Examples

# Remove reviewer by account ID
bb pr reviewers remove 42 "712020:3cfed7e0-0ed6-49fc-bb35-410a00ccee6f"

# Remove reviewer by UUID (note the braces)
bb pr reviewers remove 42 "{c1cb1bb5-2e32-456e-a373-43978dc12aa1}"

# Remove reviewer in specific repository
bb pr reviewers remove 42 "712020:3cfed7e0-0ed6-49fc-bb35-410a00ccee6f" -w myworkspace -r myrepo

# Remove reviewer and get result as JSON
bb pr reviewers remove 42 "712020:3cfed7e0-0ed6-49fc-bb35-410a00ccee6f" --json

Notes

The user must exist in Bitbucket; you’ll get a clear error message if the user is not found
If the user is not a reviewer on the PR, the command succeeds without making changes
Uses UUID for identification (GDPR-compliant)