Skip to content

Reviewers

Manage pull request reviewers.

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

SubcommandDescription
list <id>List reviewers on a pull request
add <id> <username>Add a reviewer to a pull request
remove <id> <username>Remove a reviewer from a pull request

List reviewers assigned to a pull request.

Terminal window
bb pr reviewers list <id>
ArgumentDescription
idPull request ID
OptionDescription
-w, --workspace <workspace>Workspace
-r, --repo <repo>Repository
--jsonOutput as JSON
Terminal window
# 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
  • 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

Add a reviewer to a pull request by username.

Terminal window
bb pr reviewers add <id> <username>
ArgumentDescription
idPull request ID
usernameUsername of the user to add as reviewer
OptionDescription
-w, --workspace <workspace>Workspace
-r, --repo <repo>Repository
--jsonOutput as JSON
Terminal window
# Add johndoe as reviewer to PR #42
bb pr reviewers add 42 johndoe
# Add reviewer in specific repository
bb pr reviewers add 42 johndoe -w myworkspace -r myrepo
# Add reviewer and get result as JSON
bb pr reviewers add 42 johndoe --json
  • 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)

Remove a reviewer from a pull request.

Terminal window
bb pr reviewers remove <id> <username>
ArgumentDescription
idPull request ID
usernameUsername of the reviewer to remove
OptionDescription
-w, --workspace <workspace>Workspace
-r, --repo <repo>Repository
--jsonOutput as JSON
Terminal window
# Remove johndoe as reviewer from PR #42
bb pr reviewers remove 42 johndoe
# Remove reviewer in specific repository
bb pr reviewers remove 42 johndoe -w myworkspace -r myrepo
# Remove reviewer and get result as JSON
bb pr reviewers remove 42 johndoe --json
  • 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)