Create a new repository in Bitbucket

Search repositories using Bitbucket's query syntax: name (name ~ "pattern"), project key (project.key = "PROJ"), language (language = "python"), or dates (updated_on >= "2024-01-19", ISO 8601 only). To search file contents instead, use bb_list_endpoints for the code-search endpoints.

Create a new branch in a Bitbucket repository

Read a file from a Bitbucket repository

Write or update a file in a Bitbucket repository

Delete a file from a Bitbucket repository

Create an issue in a Bitbucket repository

Delete an issue from a Bitbucket repository

Create a new pull request in a Bitbucket repository

Get details of a pull request in a Bitbucket repository

Get the diffstat for a pull request: every modified file with its added/removed line counts and a totals summary

Get one file's content at both the source and destination branches of a pull request, for side-by-side review

Get the line-by-line diff for one specific file in a pull request

Get the complete diff for every modified file in a pull request in a single call - much more efficient than calling bb_get_pr_file_diff per file

List pull requests in a repository, optionally filtered by state, source or destination branch, or author. Use the source_branch filter to resolve a branch name to its PR number when the user names a branch instead of a PR.

List comments on a pull request, showing which are inline (with file and line), which are replies, and which threads are resolved

Add a comment to a pull request. Pass file_path and line together to anchor it inline on that line of the diff; pass parent_id to reply within an existing thread; pass neither for a general PR comment.

Mark a pull request comment thread as resolved

Approve a pull request as the authenticated user. This is visible to the team - only call it when the user has asked for an approval.

Request changes on a pull request as the authenticated user. Visible to the team - only call it when the user has asked to request changes.

Search the full Bitbucket Cloud REST API (all endpoints, generated from Atlassian's official OpenAPI spec) to find the right method, path and params for a task. Call this FIRST whenever no purpose-built bb_* tool covers what you need, then pass the result to bb_request. Every whitespace-separated term in search must match, so 'pull request comment' narrows better than 'comment'.

Call ANY Bitbucket Cloud 2.0 REST endpoint directly. This is the escape hatch for everything the purpose-built bb_* tools do not wrap - merges, commit comparison, branches and tags, pipelines, code search, webhooks, permissions. Use bb_list_endpoints first to get the exact path and params. Paths are relative to https://api.bitbucket.org/2.0 and must have real values substituted for {placeholders}. Set paginate=true on list endpoints to follow Bitbucket's next links and merge all pages.