Reference

Create a branch

Automatically create a new branch in your Bitbucket repository to organize feature development, bug fixes, or experimental work without manual setup in the UI.

Get branch

Retrieve detailed information about a specific branch in your Bitbucket repository, including its current commit and metadata. Use this to verify branch status, track which commits are deployed, or confirm a branch exists before performing actions on it.

Get effective branching model

Retrieves the current branching model configuration for a Bitbucket repository, including inherited project-level settings, to understand your team's branch workflow structure.

Get Repository Branching Model

Retrieve your repository's branching strategy and branch naming conventions to understand how code flows through your development workflow.

Create an issue comment

Add comments to existing Bitbucket issues to provide updates, feedback, or ask questions on code discussions and bug reports.

Create pull request comment

Add comments to pull requests in Bitbucket to provide code feedback, ask questions, or discuss changes with your team. This helps streamline code reviews and keep all feedback organized in one place.

Create snippet comment

Add comments or replies to code snippets in Bitbucket to provide feedback, ask questions, or collaborate with team members on shared code segments.

Delete commit comment

Remove a comment you posted on a commit when it's no longer relevant, incorrect, or needs to be cleaned up from your repository's history.

Delete pull request comment

Permanently removes a comment from a pull request, allowing you to clean up outdated feedback, incorrect suggestions, or unwanted discussions during code reviews.

Get commit comment

Retrieves the full details of a specific comment on a commit, including the message, author, and when it was posted. Use this to review feedback or discussions tied to your code changes without having to browse through your entire commit history.

Get commit comments

Retrieve all comments and feedback that team members have left on a specific commit, including both general discussions and inline code notes. This helps you track code review conversations and implementation decisions in one place.

Get pull request comment

Retrieve the full details of a specific comment from a pull request, including its content, author information, and when it was posted. This helps you access individual feedback or discussions without loading the entire pull request.

Get Commit Build Status

Retrieve the build status of a specific commit to see if tests passed, failed, or are still running. This helps you verify code quality before merging or deploying.

Get Commit Changes

Retrieve all files and changes made in a specific commit, including details about lines added, removed, and modification status. This helps you understand exactly what code changes were made in each commit for review and audit purposes.

Get Commit Diff

Retrieve detailed code changes between commits or within a single commit in your Bitbucket repository. Use this to understand exactly what code was modified, added, or removed without having to review files manually.

Get commit statuses

Retrieves all build and deployment statuses for a specific commit, allowing you to check CI/CD pipeline results and test outcomes at a glance.

Get Repositories Merge Base

Finds the common ancestor commit between two branches or commits in your Bitbucket repository, helping you understand what changes are unique to each branch before merging.

Get Repository Commit

Retrieve detailed information about a specific commit in your Bitbucket repository, including author details, commit message, timestamp, and related metadata to track code changes and history.

List commits from revision (POST)

Retrieve a list of commits from a specific revision in your Bitbucket repository, with support for complex filtering parameters that may exceed URL length limits.

Get deployment environment variables

Retrieve configuration variables that are set for a specific deployment environment in your Bitbucket repository, allowing you to review what settings are active for that environment.

Get Repository Environment

Retrieve detailed configuration and settings for a specific deployment environment in your Bitbucket repository, including deployment rules and restrictions.

Create an issue

Create a new issue in your Bitbucket repository to track bugs, feature requests, or tasks with automatic validation of assignees and project references.

Check if user voted for issue

Verify whether you've already voted on a specific issue in your Bitbucket repository to avoid duplicate votes and track your engagement.

Delete issue

Permanently remove a specific issue from your Bitbucket repository to clean up resolved, duplicate, or outdated tracked items.

Create team pipeline variable

Set up environment variables and configuration values that are automatically available to all your team's automated pipelines, eliminating the need to configure the same settings repeatedly across different projects.

Create user pipeline variable

Creates account-level configuration variables that can be reused across all your Bitbucket repositories, eliminating the need to set the same values repeatedly for each project.

Delete user pipeline variable

Remove user-level pipeline variables that are no longer needed, helping you keep your CI/CD configuration clean and organized.

Get repository pipelines caches

Retrieve all configured caches for your repository's CI/CD pipelines, helping you understand what build artifacts and dependencies are being cached to optimize pipeline performance.

Get specific pipeline

Fetch detailed information about a specific pipeline execution in your Bitbucket repository, including its current status, build number, and test results. This helps you monitor the health and progress of individual builds without manually checking the Bitbucket interface.

Create a pull request

Automatically create pull requests in Bitbucket to streamline code review workflows and maintain organized development branches without manual setup.

Approve Pull Request

Formally approve a pull request to signal that you've reviewed the changes and they're ready to merge. This is essential for maintaining code quality and facilitating team collaboration in your development workflow.

Get Pull Request

Retrieve detailed information about a specific pull request, including status, reviewers, and changes, to understand the current state of code reviews and collaboration.

Get Pull Request Commits

Retrieves all commits included in a pull request, allowing you to review the specific changes and work history within that PR without navigating Bitbucket directly.

Get Pull Request Diff

Retrieve the complete code changes from a pull request in Bitbucket to review what was modified. This helps you understand the differences between branches before approving or merging code.

Get Pull Request Diffstat

Retrieve detailed statistics about changes in a pull request, including which files were modified and how many lines were added or removed in each file. This helps you quickly understand the scope and impact of code changes without reviewing the entire diff.

Create commit report annotations

Add code analysis findings like vulnerabilities, bugs, and code smells directly to your commit reports, helping your team catch quality issues before code reaches production. This enables automated feedback on code changes without leaving your development workflow.

Delete commit report annotation

Remove unwanted annotations from your commit code analysis reports to keep your repository documentation accurate and up-to-date. This helps maintain clean feedback history by deleting specific comments or findings that are no longer relevant.

Get commit report

Retrieves a specific analysis report attached to a commit, such as security scans, code coverage, or test results. This helps you track code quality and identify issues in your project without manually checking each commit.

Get commit report annotation

Retrieve detailed information about a specific code analysis finding (such as a vulnerability, code smell, or bug) from a commit report by its ID. This helps you review and understand individual issues identified in your code reviews.

Get Commit Reports

Retrieve analysis results, test reports, security scans, and code coverage data linked to a specific commit in your Bitbucket repository. This helps you track code quality and testing metrics for each change in your project.

Browse repository path

Access and view file contents or directory listings from your Bitbucket repository at any point in your project's history. Use this to inspect code, documentation, or assets without cloning the entire repository.

Create repository

Creates a new Git repository in your Bitbucket workspace to organize and version control your code projects. This helps you establish a central place to store, manage, and collaborate on source code.

Delete repository

Permanently removes a repository from your Bitbucket workspace. This action cannot be undone, and any forks of the repository remain unaffected.

Get file commit history

Retrieves the complete commit history for a specific file, showing all changes, who made them, and when they occurred. Use this to track file evolution, identify responsible parties for modifications, and understand when critical changes were introduced.

Get file from repository

Retrieves the content of a specific file from your Bitbucket repository at any point in time, using commit references, branches, or tags. This lets you access code, documentation, or configuration files programmatically without manually downloading them.

Get raw file content

Retrieves the raw content of a file from a Bitbucket repository at a specific commit, branch, or tag, allowing you to access and read file contents programmatically without viewing the Bitbucket interface.

Get OpenID configuration for OIDC in Pipelines

Retrieves the OpenID Connect configuration needed to securely authenticate Bitbucket Pipelines with external services like AWS, Google Cloud, or HashiCorp Vault without storing credentials in your repository.

Delete snippet watch

Stops receiving notifications for a specific code snippet by removing your watch. Use this when you're no longer interested in updates about a particular snippet.

Get current user (v2)

Retrieves your complete Bitbucket profile information to verify your account details and access your account ID, username, and other profile data. Useful for confirming your identity and pulling your account information into other systems.

Get hook events

Retrieves all available webhook event types that can be monitored for a repository or workspace, helping you understand which actions you can automate. Use this to discover and configure automated workflows triggered by specific Bitbucket events.

Get pipeline steps

Retrieves all steps for a given pipeline.

Get pull request comments

Retrieves a paginated list of comments on a specific pull request in a Bitbucket repository.

Get pull request statuses

Returns all build statuses (e.g., CI/CD pipeline results) for a specific pull request.

Get pull requests activity log

Get paginated activity log for all pull requests in a repository.

Get repositories src

Lists the contents of the root directory on the repository's main branch without needing to specify a commit or branch.

Get repository

Retrieves detailed information about a specific repository in a Bitbucket workspace.

Get Repository Patch

Tool to retrieve the git patch content for a Bitbucket repository at a specified revision or commit range.

Get repository pipeline runners

Retrieves the list of self-hosted runners configured for a repository's pipelines.

Get repository pipeline schedules

Retrieves configured pipeline schedules for a Bitbucket repository.

Get repository pipeline variables

Retrieves repository-level pipeline variables for a specific Bitbucket repository.

Get repository refs

Returns the branches and tags in the repository.

Get repository SSH known hosts

Retrieves repository-level SSH known hosts configured for Bitbucket Pipelines.

Get repository watchers

Retrieves a paginated list of all the watchers on the specified repository.

Get snippet

Retrieves a specific Bitbucket snippet by its encoded ID from an existing workspace, returning its metadata and file structure.

Get snippet watch status

Checks if the current user is watching a specific snippet.

Get SSH keys for user

Retrieves a paginated list of SSH keys for a specified Bitbucket user.

Get tag

Retrieves detailed information about a specific tag in a Bitbucket repository.

Get user

Retrieves public profile information for a specific Bitbucket user by username or UUID.

Get user email details

Retrieves details about a specific email address for the authenticated user.

Get user emails

Returns all the authenticated user's email addresses, both confirmed and unconfirmed.

Get user permissions for repositories

Returns an object for each repository the caller has explicit access to, including their permission level.

Get user permissions for workspaces

Retrieves workspace memberships and permission levels for the authenticated user.

Get user workspaces

Tool to retrieve all workspaces accessible to the authenticated user.

Get workspace

Retrieves detailed information about a specific Bitbucket workspace.

Get Workspace Pull Requests by User

Tool to get all workspace pull requests authored by a specified user.

List all public repositories

Retrieves a paginated list of all public repositories on Bitbucket.

List branches

Lists branches in a Bitbucket repository with optional server-side filtering by name pattern (BBQL) and sorting.

List commits

Tool to retrieve a page of commits from a Bitbucket repository.

List commits from revision

Tool to list commits starting from a specific revision in a Bitbucket repository.

List commits on master

Lists commits on the master branch of a Bitbucket repository.

List deployments

Lists deployments for a specified Bitbucket repository.

List issues in a repository

Lists issues in a Bitbucket repository with optional filtering by state, priority, kind, or assignee.

List pipelines

Tool to find pipelines in a Bitbucket repository.

List pull request tasks

Lists all tasks associated with a pull request in a Bitbucket repository.

List pull requests

Lists pull requests in a specified, accessible Bitbucket repository, optionally filtering by state (OPEN, MERGED, DECLINED).

List repositories in workspace

Lists repositories in a specified Bitbucket workspace, accessible to the authenticated user, with options to filter by role or query string, and sort results.

List repository environments

List all deployment environments configured for a Bitbucket repository.

List repository paths

Lists file and directory entries under a repository path at a given revision, with optional breadth-first recursion via maxdepth for repository traversal and…

List snippets

Returns all snippets accessible to the authenticated user.

List tags

Lists tags in a Bitbucket repository with optional server-side filtering by name pattern or commit hash (BBQL) and sorting.

List versions

Lists versions (milestones) in a Bitbucket repository's issue tracker.

List workspace members

Lists all members of a specified Bitbucket workspace; the workspace must exist.

List workspace projects

Lists projects in a specified Bitbucket workspace.

List workspaces

Lists Bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted.

Merge Pull Request

Tool to merge a Bitbucket Cloud pull request via the REST API.

Request Pull Request Changes

Tool to request changes on a pull request as the authenticated user.

Resolve pull request comment

Tool to resolve or reopen a pull request comment thread.

Search code in team repositories

Search for code in repositories of a specified team.

Search code in user repositories

Tool to search for code in the repositories of a specified user.

Search code in workspace

Tool to search for code in the repositories of the specified workspace.

Update an issue

Updates an existing issue in a Bitbucket repository by modifying specified attributes; requires workspace, reposlug, issueid, and at least one attribute to…

Update commit comment

Updates the contents of a comment on a commit.

Update commit insight report

Create or update an insight report for a commit.

Update commit report annotation

Creates or updates an individual annotation for a commit report.

Update Pull Request

Tool to update an existing pull request's editable fields (e.g., title, description, reviewers) via the Bitbucket Cloud API.

Update team pipeline variable

Updates a team-level pipeline configuration variable in Bitbucket.

Update user pipeline variable

Updates a user-level pipeline variable for Bitbucket pipelines.