Bitbucket logo

Integrate Bitbucket with your AI CRM

Bitbucket is a Git-based code hosting and collaboration platform supporting private and public repositories, enabling teams to manage and review code through pull requests and integrations

Explore Triggers and Actions

Approve Pull Request

Tool to approve a pull request as the authenticated user. Use when you need to formally approve changes in a pull request review process.

ActionTry it

Browse repository path

Retrieves file content or browses directory contents at a specified revision in a Bitbucket repository. File content is returned as text or base64-encoded binary data; directory listings are paginated, and metadata can also be requested.

ActionTry it

Check if user voted for issue

Tool to check whether the authenticated user has voted for a specific issue in a Bitbucket repository. Use when you need to verify if the current user has already voted on an issue before attempting to vote or unvote.

ActionTry it

Create a branch

Creates a new branch in a Bitbucket repository from a target commit hash; the branch name must be unique, adhere to Bitbucket's naming conventions, and not include the 'refs/heads/' prefix.

ActionTry it

Create a pull request

Creates a new pull request in a specified Bitbucket repository, ensuring the source branch exists and is distinct from the (optional) destination branch.

ActionTry it

Create an issue

Creates a new issue in a Bitbucket repository, setting the authenticated user as reporter; ensures assignee (if provided) has repository access, and that any specified milestone, version, or component IDs exist.

ActionTry it

Create an issue comment

Adds a new comment with markdown support to an existing Bitbucket issue.

ActionTry it

Create commit report annotations

Adds multiple annotations to a commit report in bulk. Use when you need to add code analysis findings (vulnerabilities, code smells, bugs) to a report attached to a specific commit.

ActionTry it

Create pull request comment

Creates a new comment on a Bitbucket pull request. Supports top-level comments, threaded replies, and inline code comments. Use when providing feedback on a PR, replying to existing comments, or commenting on specific code lines.

ActionTry it

Create repository

Creates a new Bitbucket 'git' repository in a specified workspace, defaulting to the workspace's oldest project if `project_key` is not provided.

ActionTry it

Create snippet comment

Posts a new top-level comment or a threaded reply to an existing comment on a specified Bitbucket snippet.

ActionTry it

Create team pipeline variable

Creates a workspace-level pipeline configuration variable in Bitbucket for the workspace identified by the supplied team username. Use to add environment variables or configuration values for pipelines in that workspace.

ActionTry it

Create user pipeline variable

Creates a user-level pipeline variable for Bitbucket pipelines. Use when you need to create account-level configuration variables that can be used across all repositories owned by the user.

ActionTry it

Decline Pull Request

Decline a Bitbucket Cloud pull request via the REST API. Use this action when you need to reject a pull request that should not be merged. This action is irreversible — once declined, the pull request cannot be reopened and must be recreated if needed.

ActionTry it

Delete commit comment

Permanently deletes a specific comment on a commit. Use when removing outdated, incorrect, or unwanted feedback on a commit.

ActionTry it

Delete commit report annotation

Deletes a single annotation matching the provided ID from a commit report. Use when you need to remove a specific annotation from a code analysis report.

ActionTry it

Delete issue

Permanently deletes a specific issue, identified by its `issue_id`, from the repository specified by `repo_slug` within the given `workspace`.

ActionTry it

Delete pull request comment

Permanently deletes a specific pull request comment (top-level, inline, or threaded reply). Use when removing outdated, incorrect, or unwanted feedback from a pull request.

ActionTry it

Delete repository

Permanently deletes a specified Bitbucket repository; this action is irreversible and does not affect forks.

ActionTry it

Delete snippet watch

Stops watching a specific snippet. Use when you want to unsubscribe from notifications for a snippet.

ActionTry it

Delete user pipeline variable

Permanently deletes a user-level pipeline configuration variable identified by its UUID. Use this to remove pipeline variables that are no longer needed at the account level.

ActionTry it

Download repository archive

Download a repository revision as a zip, gzip, or bzip2 archive.

ActionTry it

Get branch

Retrieves detailed information about a specific branch in a Bitbucket repository. Use when you need to get branch metadata, the commit it points to, or verify a branch exists.

ActionTry it

Get Commit Build Status

Get a specific build status for a commit in Bitbucket. Use when you need to check the status of a particular build/CI run for a commit.

ActionTry it

Get Commit Changes

Tool to retrieve a page of changes made in a specified commit, showing all changed files with their change statistics (lines added/removed, status). Use when you need to enumerate files modified in a specific commit or commit range.

ActionTry it

Get commit comment

Retrieves a specific comment from a commit by its ID. Use when you need to fetch details of a particular commit comment including content, author, timestamps, and inline location.

ActionTry it

Get commit comments

Retrieves a page of comments on a specific commit in a Bitbucket repository, including global and inline code comments. Use it to view feedback, discussions, or notes on the commit.

ActionTry it

Get Commit Diff

Tool to retrieve the unified diff between two provided revisions or for a single commit in a Bitbucket repository. Use when you need to see the actual code changes in a commit or between two commits. Supports filtering by file path and various diff options.

ActionTry it

Get commit report

Returns a single report matching the provided ID from a commit. Use when you need to retrieve details of a specific analysis report (e.g., security scan, code coverage, test results, or bug report) for a commit.

ActionTry it

Get commit report annotation

Returns a single annotation matching the provided ID from a commit report. Use when you need to retrieve details of a specific code analysis finding (e.g., vulnerability, code smell, or bug) identified in a commit.

ActionTry it

Get Commit Reports

Tool to get reports linked to a specific commit. Use when you need to retrieve analysis results, test reports, security scans, or code coverage data associated with a commit.

ActionTry it

Get commit statuses

Returns a page of build statuses, such as CI/CD pipeline results, for a specific commit. Use it to check build status or monitor pipeline results for that commit.

ActionTry it

Get current user (v2)

Tool to retrieve complete profile information for the currently authenticated Bitbucket user. Use when you need comprehensive user details including account_id, username, nickname, and other profile fields.

ActionTry it

Get deployment environment variables

Retrieves deployment environment level variables for a specific Bitbucket repository environment. Use when you need to view or audit environment-specific configuration variables for deployments.

ActionTry it

Get effective branching model

Retrieves the effective branching model for a Bitbucket repository, showing which branching model is currently applied (including any inheritance from project-level settings). Use when you need to understand the repository's branch workflow configuration, including development and production branches and branch type prefixes.

ActionTry it

Get file commit history

Returns a paginated list of commits that modified the specified file. Use when you need to track file changes over time, find who modified a file, or determine when a file was created or last changed.

ActionTry it

Get file from repository

Retrieves a specific file's content from a Bitbucket repository at a given commit (hash, branch, or tag), failing if the file path is invalid for that commit.

ActionTry it

Get hook events

Retrieves a paginated list of all valid webhook events for a specified entity type (repository or workspace). Use when you need to discover available webhook event types for subscription or webhook configuration.

ActionTry it

Get OpenID configuration for OIDC in Pipelines

Retrieves the OpenID Connect discovery configuration for Bitbucket Pipelines OIDC. Use when integrating Bitbucket Pipelines with resource servers (AWS, GCP, Vault) using OpenID Connect authentication. Returns issuer URL, JWKS URI, and supported capabilities.

ActionTry it

Get pipeline step

Retrieve one pipeline step and its available execution details by UUID.

ActionTry it

Get pipeline step log

Retrieve all or a bounded byte range of one pipeline step's execution log.

ActionTry it

Get pipeline steps

Retrieves a page of steps for a given pipeline, including available state, duration, and command details.

ActionTry it

Get Pull Request

Get a single pull request by ID, returning its modeled details.

ActionTry it

Get pull request activity

Return one pull request's comments, updates, approvals, and change requests.

ActionTry it

Get pull request comment

Tool to retrieve a specific comment from a pull request by its ID. Use when you need to fetch details of a particular pull request comment including content, author, timestamps, and inline location.

ActionTry it

Get pull request comments

Retrieves a paginated list of comments on a specific pull request in a Bitbucket repository. Returns global, inline, and threaded comments. Use when you need to view feedback, discussions, or reviews left on a pull request.

ActionTry it

Get Pull Request Commits

Tool to retrieve commits for a specified pull request. Use when reviewing the commit history of a PR or analyzing changes included in a pull request.

ActionTry it

Get Pull Request Diff

Tool to fetch the unified diff for a Bitbucket pull request (follows 302 redirect to repository diff). Use when reviewing code changes in a PR. Supports optional truncation for large diffs via max_chars parameter.

ActionTry it

Get Pull Request Diffstat

Get a paginated diffstat for a Bitbucket pull request, showing changed files and their change statistics, including lines added, lines removed, and status.

ActionTry it

Get pull request merge base

Resolve a pull request's refs and return their best common ancestor commit when the source and destination are in the same repository.

ActionTry it

Get pull request statuses

Returns a page of build statuses for a specific pull request, such as CI/CD pipeline results. Use it to check build status or monitor pull request checks.

ActionTry it

Get pull requests activity log

Gets a paginated activity log for pull requests in a repository, including comments, updates, and approvals.

ActionTry it

Get raw file content

DEPRECATED: Use BITBUCKET_GET_FILE_FROM_REPOSITORY instead. Tool to retrieve the raw content of a file from a Bitbucket repository at a specified commit, branch, or tag. Use when you need to read file contents from a specific revision.

ActionTry it

Get Repositories Merge Base

Get the merge base (best common ancestor) between two commits in a Bitbucket repository. Use when you need to find the common ancestor commit between two branches or commits for comparison or merge operations.

ActionTry it

Get repositories src

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

ActionTry it

Get repository

Retrieves detailed information about a specific repository in a Bitbucket workspace. Use when you need to get repository metadata, settings, or details.

ActionTry it

Get Repository Branching Model

Return the branching model as applied to the repository. Use when you need to understand the repository's branch workflow configuration, including development/production branches and branch type prefixes.

ActionTry it

Get Repository Commit

Tool to retrieve detailed information about a specific commit in a Bitbucket repository. Use when you need to get complete commit details including author, message, date, parents, and related links.

ActionTry it

Get Repository Environment

Retrieve detailed information about a specific deployment environment in a Bitbucket repository. Use when you need to get environment configuration, deployment settings, or check environment properties like locks and restrictions.

ActionTry it

Get Repository Patch

Retrieves the Git patch for a Bitbucket repository at a specified revision or commit range in unified diff format. An optional character limit can truncate the patch; the response reports whether truncation occurred.

ActionTry it

Get repository pipeline runners

Retrieves the list of self-hosted runners configured for a repository's pipelines. Use when you need to view available runners for pipeline execution.

ActionTry it

Get repository pipeline schedules

Retrieves configured pipeline schedules for a Bitbucket repository. Use when you need to view scheduled pipeline runs and their cron patterns.

ActionTry it

Get repository pipeline variables

Retrieves repository-level pipeline variables for a specific Bitbucket repository. Use when you need to view or audit pipeline configuration variables that are scoped to a repository.

ActionTry it

Get repository pipelines caches

Retrieves a page of pipeline caches for a specific Bitbucket repository.

ActionTry it

Get repository refs

Returns a paginated list of branches and tags in a repository, with optional query filtering by type, name pattern, or commit hash.

ActionTry it

Get repository SSH known hosts

Retrieves repository-level SSH known hosts configured for Bitbucket Pipelines. Use when you need to list or verify SSH known hosts that Pipelines can connect to during builds.

ActionTry it

Get repository watchers

Retrieves a paginated list of all the watchers on the specified repository. Use when you need to see who is watching a particular repository.

ActionTry it

Get snippet

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

ActionTry it

Get snippet watch status

Checks if the current user is watching a specific snippet. Use when you need to verify watch status for a snippet.

ActionTry it

Get specific pipeline

Retrieve a specified pipeline from a Bitbucket repository. Use when you need to get detailed information about a specific pipeline execution including its status, build number, and results.

ActionTry it

Get SSH keys for user

Retrieves a paginated list of SSH keys for a specified Bitbucket user. Use when you need to view or audit SSH keys configured for a user account.

ActionTry it

Get tag

Retrieves detailed information about a specific tag in a Bitbucket repository. Use when you need to get tag metadata, target commit details, or verify a tag exists.

ActionTry it

Get user

Retrieves public profile information for a specific Bitbucket user by username or UUID. Use when you need to get user details like display name, avatar, creation date, and links to related resources.

ActionTry it

Get user email details

Retrieves details about a specific email address for the authenticated user. Use when you need to check if an email is primary, confirmed, or verify email ownership.

ActionTry it

Get user emails

Retrieves a page of the authenticated user's email addresses, including confirmed and unconfirmed addresses, with pagination links when provided.

ActionTry it

Get user permissions for repositories

Retrieves a page of repository permissions for repositories the authenticated user has explicit access to, including permission levels. Supports pagination.

ActionTry it

Get user permissions for workspaces

Retrieves a page of workspace memberships and permission levels for the authenticated user, including their effective role. Supports filtering and pagination.

ActionTry it

Get user workspaces

Retrieves a page of workspaces accessible to the authenticated user, optionally filtered by workspace slug or permission level. The response may include a link to the next page.

ActionTry it

Get workspace

Retrieves detailed information about a specific Bitbucket workspace. Use when you need to get workspace metadata, settings, or details.

ActionTry it

Get Workspace Pull Requests by User

Retrieves a page of workspace pull requests filtered by author and optionally by state across repositories. Results may be incomplete if a repository's pull request request fails; pagination links are not provided.

ActionTry it

List all public repositories

Retrieves a paginated list of all public repositories on Bitbucket. Use when you need to discover or search across public repositories, optionally filtered by role, query string, creation date, or sorted by various fields.

ActionTry it

List branches

Lists branches in a Bitbucket repository with optional server-side filtering by name pattern (BBQL) and sorting. Use when you need to discover available branches, search for specific branch patterns, or navigate repository branch structure.

ActionTry it

List commits

Tool to retrieve a page of commits from a Bitbucket repository. Returns commits in reverse chronological order (newest first), similar to git log. Use when you need to browse commit history, filter commits by branch/tag, or restrict to commits affecting a specific path.

ActionTry it

List commits from revision

Tool to list commits starting from a specific revision in a Bitbucket repository. Commits are paginated and returned in reverse chronological order. Use when you need to retrieve commit history from a specific commit, branch, or tag.

ActionTry it

List commits from revision (POST)

Tool to list commits from a revision using POST method. Identical to GET endpoint but allows sending include/exclude parameters in request body to avoid URL length limits. Use when include/exclude parameters are too long for query strings.

ActionTry it

List commits on master

Lists commits on the master branch of a Bitbucket repository. Use when you need to retrieve the commit history for the master branch, including commit messages, authors, dates, and parent relationships.

ActionTry it

List deployments

Lists deployments for a specified Bitbucket repository. Use when you need to view deployment history and status across environments.

ActionTry it

List issues in a repository

Lists issues in a Bitbucket repository with optional filtering by state, priority, kind, or assignee. Use when you need to discover issue IDs or get an overview of repository issues.

ActionTry it

List pipeline step test cases

Return test cases discovered for one pipeline step, including failures and durations.

ActionTry it

List pipelines

List pipelines in a Bitbucket repository, returning pipeline metadata including state, trigger, and build seconds used. Use to browse pipeline history or check pipeline status.

ActionTry it

List pull request mergeability checks

Return Bitbucket's current pre-merge checks for one pull request. The result is not exhaustive because Bitbucket cannot evaluate every merge condition before attempting the merge. Use each check's ``blocking`` field, not ``status`` alone, to determine whether it currently prevents merging.

ActionTry it

List pull request tasks

Lists a page of tasks associated with a pull request in a Bitbucket repository, with pagination metadata.

ActionTry it

List pull requests

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

ActionTry it

List pull requests for commit

List pull requests in which a repository commit was reviewed. Requires Bitbucket's Pull Request Commit Links app to be installed and the repository to be indexed.

ActionTry it

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. Responses are paginated; iterate using the `next` field in each response until it is absent to retrieve all repositories.

ActionTry it

List repository environments

Lists a page of deployment environments configured for a Bitbucket repository, with optional filtering and sorting. Use it to view available environments, check their configurations, or select one for deployment operations.

ActionTry it

List repository forks

Retrieves a paginated list of all forks for a specific repository in a Bitbucket workspace. Returns repository objects for each fork with metadata like owner, creation date, and size. Use this action when you need to discover who has forked a repository or analyze fork relationships.

ActionTry it

List repository paths

Lists file and directory entries under a repository path at a given revision, with optional breadth-first recursion via max_depth for repository traversal and scanning. Fails if the path points to a file rather than a directory.

ActionTry it

List snippets

Lists a page of snippets accessible to the authenticated user, optionally filtered by role (owner, contributor, or member). Pagination parameters select the page and page size.

ActionTry it

List tags

Lists tags in a Bitbucket repository with optional server-side filtering by name pattern or commit hash (BBQL) and sorting. Use when you need to discover available tags, search for specific tag patterns, or find tags pointing to specific commits.

ActionTry it

List versions

Lists versions (milestones) in a Bitbucket repository's issue tracker. Use when you need to discover available versions for associating with issues, or to retrieve version IDs for use with create_issue.

ActionTry it

List workspace members

Lists members of a specified Bitbucket workspace, returning one page of results.

ActionTry it

List workspace projects

Lists projects in a specified Bitbucket workspace, returning a page of results with optional filtering and sorting.

ActionTry it

List workspaces

Lists Bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted. Results are paginated; follow the `next` field in each response to retrieve subsequent pages until `next` is absent. When multiple workspaces are returned, verify the correct `slug` or UUID before passing to downstream tools.

ActionTry it

Merge Pull Request

Merge a Bitbucket Cloud pull request, with optional custom merge message, merge strategy, and source branch deletion. The merge may complete asynchronously, returning task details to check completion.

ActionTry it

Request Pull Request Changes

Tool to request changes on a pull request as the authenticated user. Use when you need to formally request changes in a pull request review process, indicating the PR needs modifications before approval.

ActionTry it

Resolve pull request comment

Tool to resolve or reopen a pull request comment thread. Use when marking a comment as addressed during review or reopening a previously resolved thread.

ActionTry it

Search code in team repositories

Search for code in repositories of a specified team. Matches can occur in file content or paths. Note: Teams endpoints were deprecated in Oct 2020; use workspace search endpoints for new integrations.

ActionTry it

Search code in user repositories

Tool to search for code in the repositories of a specified user. Use when you need to find specific code patterns, functions, or text across all repositories owned by a user.

ActionTry it

Search code in workspace

Tool to search for code in the repositories of the specified workspace. Use when you need to find specific code patterns, function definitions, or text across all repositories in a workspace.

ActionTry it

Stop pipeline

Signal the stop of a pipeline and all of its steps that have not completed yet. This action is irreversible — once stopped, a pipeline cannot be restarted and must be re-triggered to run again. Use this action when you need to cancel a running pipeline execution that is no longer needed or was triggered incorrectly.

ActionTry it

Update an issue

Updates an existing issue in a Bitbucket repository by modifying specified attributes; requires `workspace`, `repo_slug`, `issue_id`, and at least one attribute to update.

ActionTry it

Update commit comment

Updates the contents of a comment on a commit. Use when you need to modify an existing comment's text on a commit.

ActionTry it

Update commit insight report

Create or update an insight report for a commit. Creates a new report if it doesn't exist, or replaces the existing one if a report already exists for the given repository, commit, and report key. Note: replacing an existing report will be rejected if the authenticated user was not the creator of the specified report.

ActionTry it

Update commit report annotation

Creates or updates an individual annotation for a commit report. Use when you need to add or modify code analysis findings (vulnerabilities, code smells, or bugs) identified in a commit.

ActionTry it

Update Pull Request

Tool to update an existing pull request's editable fields (e.g., title, description, reviewers) via the Bitbucket Cloud API. Use when you need to modify a pull request without creating a new one. Only sends fields that are explicitly provided to avoid accidental overwrites.

ActionTry it

Update team pipeline variable

Updates a team-level pipeline configuration variable in Bitbucket. Use when you need to modify existing environment variables or configuration values that are available to all pipelines within a team.

ActionTry it

Update user pipeline variable

Updates a user-level pipeline variable for Bitbucket pipelines. Use when you need to modify account-level configuration variables such as changing the value, key name, or security status.

ActionTry it

How the Bitbucket integration works

The Bitbucket integration connects your Dench AI CRM directly to Bitbucket, so agents can read and act on your Bitbucket data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.

118 actions are available for agents to invoke on your behalf. Every call runs through Bitbucket's own authorization, scoped to the account you connect.

Set up Bitbucket in Dench

  1. 1

    Sign in to your Dench workspace and open Integrations.

  2. 2

    Find Bitbucket and click Connect — you'll authorize access through Bitbucket's own sign-in flow. No API keys or code required.

  3. 3

    Ask an agent to use Bitbucket in chat, or call it from an automation.

  4. 4

    Manage or disconnect the connection any time from workspace settings.

Frequently asked questions

How does the Bitbucket integration work with Dench?

The Dench Bitbucket integration connects your AI CRM to Bitbucket, so AI agents can work with your Bitbucket data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.

What actions can AI agents perform with Bitbucket via Dench?

The Bitbucket integration currently exposes 118 actions, including Approve Pull Request, Browse repository path, Check if user voted for issue, Create a branch, Create a pull request, and Create an issue. Agents invoke them on your behalf from chat or from automations.

Do I need to write code to connect Bitbucket to Dench?

No. You connect Bitbucket from your Dench workspace using Bitbucket's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.

Is the Bitbucket integration secure?

Connections are authorized through Bitbucket's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the Bitbucket connection from your workspace settings at any time.

Bitbucket | Dench AI CRM