Can I limit what agents can do in Bitbucket?

Yes, twice over. The connection itself has an access level (Read-only, Read + write, Full access), and on top of that you can allow, scope, or deny each individual agent from the Integrations page.

Can I connect more than one Bitbucket account?

Yes. Connect additional accounts from the same card and mark one as primary; agents use the primary unless a mission names a specific account.

How do I disconnect Bitbucket?

Open Integrations, choose the account under Bitbucket, and revoke it. Agents lose access immediately; nothing keeps working in the background.

Dev & Project Management

🪣 Bitbucket integration

Access levels: Read-only · Read + write · Full access · Verified July 15, 2026

Connect Bitbucket once and every agent in your squad can work in it for you, with exactly as much access as you decide to give, and a receipt for every call it makes.

What your squad can do in Bitbucket

Look things up, get branch; get commit build status; get commit changes, and more.
Do real work, create branch; create issue; create issue comment; create pull request, and more.
Run it on a schedule: any of the 107 available tools below can be part of a scheduled task or a mission.

How to connect

In your dashboard, open Integrations and find Bitbucket.
Click Connect and pick an access level (we recommend Read + write): this is the ceiling for every agent.
Sign in to Bitbucket in the window that opens and approve. You land back on the Integrations page with the account live.

You can change an account's access level any time under Manage. It applies instantly, no re-authorization. If the connection ever expires, the card shows Reconnect; one click re-authorizes the same account with the same settings.

Multiple accounts: connect as many as you need (say, yours and a client's). One is primary. Agents use it unless a mission says otherwise.

Access levels

The level you pick at connect time is enforced on our side for every agent call: an agent can never do more than the level allows, no matter what it's asked.

Level	What it allows
Read-only	Read account info and repos.
Read + write	Read/write code, pull requests, and issues.	Recommended
Full access	Read/write code, manage PRs, administer settings.

On top of the connection's level, every agent can be individually allowed, scoped down, or denied for this app from the Integrations page. Deny an agent and it doesn't even see the connection.

Every tool, in plain terms

The 107 tools agents use in Bitbucket through Mission Control, and the lowest access level that includes each. Agents discover these themselves. You never have to name a tool; asking in plain language is enough.

Tool	What it does	Access level
Approve pull request `BITBUCKET_APPROVE_PULL_REQUEST`	Approve a pull request as the authenticated user.	Read + write, Full access
Browse repository path `BITBUCKET_BROWSE_REPOSITORY_PATH`	Retrieve content for a file path or browse directory contents at a specified revision in a Bitbucket repository.	All levels
Create branch `BITBUCKET_CREATE_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.	Read + write, Full access
Create issue `BITBUCKET_CREATE_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.	Read + write, Full access
Create issue comment `BITBUCKET_CREATE_ISSUE_COMMENT`	Adds a new comment with markdown support to an existing Bitbucket issue.	Read + write, Full access
Create pull request `BITBUCKET_CREATE_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.	Read + write, Full access
Create pull request comment `BITBUCKET_CREATE_PULL_REQUEST_COMMENT`	Creates a new comment on a Bitbucket pull request.	Read + write, Full access
Create repositories commits2 `BITBUCKET_CREATE_REPOSITORIES_COMMITS2`	List commits from a revision using POST method.	All levels
Create repositories commit reports annotations `BITBUCKET_CREATE_REPOSITORIES_COMMIT_REPORTS_ANNOTATIONS`	Adds multiple annotations to a commit report in bulk.	Read + write, Full access
Create repository `BITBUCKET_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.	Read + write, Full access
Create snippet comment `BITBUCKET_CREATE_SNIPPET_COMMENT`	Posts a new top-level comment or a threaded reply to an existing comment on a specified Bitbucket snippet.	Read + write, Full access
Create teams pipelines config variables `BITBUCKET_CREATE_TEAMS_PIPELINES_CONFIG_VARIABLES`	Creates a team-level pipeline configuration variable in Bitbucket.	Read + write, Full access
Create users pipelines config variables `BITBUCKET_CREATE_USERS_PIPELINES_CONFIG_VARIABLES`	Creates a user-level pipeline variable for Bitbucket pipelines.	Read + write, Full access
Delete commit comment `BITBUCKET_DELETE_COMMIT_COMMENT`	Permanently deletes a specific comment on a commit.	Full access
Delete issue `BITBUCKET_DELETE_ISSUE`	Permanently deletes a specific issue, identified by its `issue_id`, from the repository specified by `repo_slug` within the given `workspace`.	Full access
Delete pull request comment `BITBUCKET_DELETE_PULL_REQUEST_COMMENT`	Permanently deletes a specific pull request comment (top-level, inline, or threaded reply).	Full access
Delete repositories commit reports annotations `BITBUCKET_DELETE_REPOSITORIES_COMMIT_REPORTS_ANNOTATIONS`	Deletes a single annotation matching the provided ID from a commit report.	Full access
Delete repository `BITBUCKET_DELETE_REPOSITORY`	Permanently deletes a specified Bitbucket repository; this action is irreversible and does not affect forks.	Full access
Delete snippets watch `BITBUCKET_DELETE_SNIPPETS_WATCH`	Stops watching a specific snippet. Use when you want to unsubscribe from notifications for a snippet.	Full access
Delete user pipeline variable `BITBUCKET_DELETE_USER_PIPELINE_VARIABLE`	Permanently deletes a user-level pipeline configuration variable identified by its UUID.	Full access
Get branch `BITBUCKET_GET_BRANCH`	Retrieves detailed information about a specific branch in a Bitbucket repository.	All levels
Get commit build status `BITBUCKET_GET_COMMIT_BUILD_STATUS`	Get a specific build status for a commit in Bitbucket.	All levels
Get commit changes `BITBUCKET_GET_COMMIT_CHANGES`	Retrieve a page of changes made in a specified commit, showing all changed files with their change statistics (lines added/removed, status).	All levels
Get commit comment `BITBUCKET_GET_COMMIT_COMMENT`	Retrieves a specific comment from a commit by its ID.	All levels
Get commit diff `BITBUCKET_GET_COMMIT_DIFF`	Retrieve the unified diff between two provided revisions or for a single commit in a Bitbucket repository.	All levels
Get current user2 `BITBUCKET_GET_CURRENT_USER2`	Retrieve complete profile information for the currently authenticated Bitbucket user.	All levels
Get deployment environment variables `BITBUCKET_GET_DEPLOYMENT_ENVIRONMENT_VARIABLES`	Retrieves deployment environment level variables for a specific Bitbucket repository environment.	All levels
Get file from repository `BITBUCKET_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.	All levels
Get hook events `BITBUCKET_GET_HOOK_EVENTS`	Retrieves a paginated list of all valid webhook events for a specified entity type (repository or workspace).	All levels
Get openid configuration `BITBUCKET_GET_OPENID_CONFIGURATION`	Retrieves the OpenID Connect discovery configuration for Bitbucket Pipelines OIDC.	All levels
Get pull request `BITBUCKET_GET_PULL_REQUEST`	Get a single pull request by ID with complete details.	All levels
Get pull request comment `BITBUCKET_GET_PULL_REQUEST_COMMENT`	Retrieve a specific comment from a pull request by its ID.	All levels
Get pull request commits `BITBUCKET_GET_PULL_REQUEST_COMMITS`	Retrieve commits for a specified pull request.	All levels
Get pull request diff `BITBUCKET_GET_PULL_REQUEST_DIFF`	Fetch the unified diff for a Bitbucket pull request (follows 302 redirect to repository diff).	All levels
Get pull request diffstat `BITBUCKET_GET_PULL_REQUEST_DIFFSTAT`	Get the diffstat for a Bitbucket pull request, showing all changed files with their change statistics (lines added/removed, status).	All levels
Get raw file content `BITBUCKET_GET_RAW_FILE_CONTENT`	DEPRECATED: Use BITBUCKET_GET_FILE_FROM_REPOSITORY instead.	All levels
Get repositories branching model `BITBUCKET_GET_REPOSITORIES_BRANCHING_MODEL`	Return the branching model as applied to the repository.	All levels
Get repositories commit `BITBUCKET_GET_REPOSITORIES_COMMIT`	Retrieve detailed information about a specific commit in a Bitbucket repository.	All levels
Get repositories commit comments `BITBUCKET_GET_REPOSITORIES_COMMIT_COMMENTS`	Retrieves all comments on a specific commit in a Bitbucket repository.	All levels
Get repositories commit report `BITBUCKET_GET_REPOSITORIES_COMMIT_REPORT`	Returns a single report matching the provided ID from a commit.	All levels
Get repositories commit reports `BITBUCKET_GET_REPOSITORIES_COMMIT_REPORTS`	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.	All levels
Get repositories commit reports annotations `BITBUCKET_GET_REPOSITORIES_COMMIT_REPORTS_ANNOTATIONS`	Returns a single annotation matching the provided ID from a commit report.	All levels
Get repositories commit statuses `BITBUCKET_GET_REPOSITORIES_COMMIT_STATUSES`	Returns all build statuses (e.g., CI/CD pipeline results) for a specific commit.	All levels
Get repositories effective branching model `BITBUCKET_GET_REPOSITORIES_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).	All levels
Get repositories environments2 `BITBUCKET_GET_REPOSITORIES_ENVIRONMENTS2`	Retrieve detailed information about a specific deployment environment in a Bitbucket repository.	All levels
Get repositories filehistory `BITBUCKET_GET_REPOSITORIES_FILEHISTORY`	Returns a paginated list of commits that modified the specified file.	All levels
Get repositories issues vote `BITBUCKET_GET_REPOSITORIES_ISSUES_VOTE`	Check whether the authenticated user has voted for a specific issue in a Bitbucket repository.	All levels
Get repositories merge base `BITBUCKET_GET_REPOSITORIES_MERGE_BASE`	Get the merge base (best common ancestor) between two commits in a Bitbucket repository.	All levels
Get repositories pipelines2 `BITBUCKET_GET_REPOSITORIES_PIPELINES2`	Retrieve a specified pipeline from a Bitbucket repository.	All levels
Get repositories pipelines config caches `BITBUCKET_GET_REPOSITORIES_PIPELINES_CONFIG_CACHES`	Retrieves the repository pipelines caches.	All levels
Get repositories pipelines config runners `BITBUCKET_GET_REPOSITORIES_PIPELINES_CONFIG_RUNNERS`	Retrieves the list of self-hosted runners configured for a repository's pipelines.	All levels
Get repositories pipelines config schedules `BITBUCKET_GET_REPOSITORIES_PIPELINES_CONFIG_SCHEDULES`	Retrieves configured pipeline schedules for a Bitbucket repository.	All levels
Get repositories pipelines config ssh known hosts `BITBUCKET_GET_REPOSITORIES_PIPELINES_CONFIG_SSH_KNOWN_HOSTS`	Retrieves repository-level SSH known hosts configured for Bitbucket Pipelines.	All levels
Get repositories pipelines config variables `BITBUCKET_GET_REPOSITORIES_PIPELINES_CONFIG_VARIABLES`	Retrieves repository-level pipeline variables for a specific Bitbucket repository.	All levels
Get repositories pipelines steps `BITBUCKET_GET_REPOSITORIES_PIPELINES_STEPS`	Retrieves all steps for a given pipeline. Use when you need to inspect the individual steps of a pipeline execution, including their state, duration, and commands.	All levels
Get repositories pullrequests activity `BITBUCKET_GET_REPOSITORIES_PULLREQUESTS_ACTIVITY`	Get paginated activity log for all pull requests in a repository.	All levels
Get repositories pullrequests comments `BITBUCKET_GET_REPOSITORIES_PULLREQUESTS_COMMENTS`	Retrieves a paginated list of comments on a specific pull request in a Bitbucket repository.	All levels
Get repositories pullrequests statuses `BITBUCKET_GET_REPOSITORIES_PULLREQUESTS_STATUSES`	Returns all build statuses (e.g., CI/CD pipeline results) for a specific pull request.	All levels
Get repositories refs `BITBUCKET_GET_REPOSITORIES_REFS`	Returns the branches and tags in the repository.	All levels
Get repositories refs tags `BITBUCKET_GET_REPOSITORIES_REFS_TAGS`	Retrieves detailed information about a specific tag in a Bitbucket repository.	All levels
Get repositories src `BITBUCKET_GET_REPOSITORIES_SRC`	Lists the contents of the root directory on the repository's main branch without needing to specify a commit or branch.	All levels
Get repositories watchers `BITBUCKET_GET_REPOSITORIES_WATCHERS`	Retrieves a paginated list of all the watchers on the specified repository.	All levels
Get repository `BITBUCKET_GET_REPOSITORY`	Retrieves detailed information about a specific repository in a Bitbucket workspace.	All levels
Get repository patch `BITBUCKET_GET_REPOSITORY_PATCH`	Retrieve the git patch content for a Bitbucket repository at a specified revision or commit range.	All levels
Get snippet `BITBUCKET_GET_SNIPPET`	Retrieves a specific Bitbucket snippet by its encoded ID from an existing workspace, returning its metadata and file structure.	All levels
Get snippets watch `BITBUCKET_GET_SNIPPETS_WATCH`	Checks if the current user is watching a specific snippet.	All levels
Get ssh latest keys `BITBUCKET_GET_SSH_LATEST_KEYS`	Retrieves a paginated list of SSH keys for a specified Bitbucket user.	All levels
Get user `BITBUCKET_GET_USER`	Retrieves public profile information for a specific Bitbucket user by username or UUID.	All levels
Get user emails `BITBUCKET_GET_USER_EMAILS`	Returns all the authenticated user's email addresses, both confirmed and unconfirmed.	All levels
Get user emails2 `BITBUCKET_GET_USER_EMAILS2`	Retrieves details about a specific email address for the authenticated user.	All levels
Get user permissions repositories `BITBUCKET_GET_USER_PERMISSIONS_REPOSITORIES`	Returns an object for each repository the caller has explicit access to, including their permission level.	All levels
Get user permissions workspaces `BITBUCKET_GET_USER_PERMISSIONS_WORKSPACES`	Retrieves workspace memberships and permission levels for the authenticated user.	All levels
Get user workspaces `BITBUCKET_GET_USER_WORKSPACES`	Retrieve all workspaces accessible to the authenticated user.	All levels
Get workspace `BITBUCKET_GET_WORKSPACE`	Retrieves detailed information about a specific Bitbucket workspace.	All levels
Get workspaces pullrequests `BITBUCKET_GET_WORKSPACES_PULLREQUESTS`	Get all workspace pull requests authored by a specified user.	All levels
Get workspaces search code `BITBUCKET_GET_WORKSPACES_SEARCH_CODE`	Search for code in the repositories of the specified workspace.	All levels
List branches `BITBUCKET_LIST_BRANCHES`	Lists branches in a Bitbucket repository with optional server-side filtering by name pattern (BBQL) and sorting.	All levels
List commits `BITBUCKET_LIST_COMMITS`	Retrieve a page of commits from a Bitbucket repository.	All levels
List commits from revision `BITBUCKET_LIST_COMMITS_FROM_REVISION`	List commits starting from a specific revision in a Bitbucket repository.	All levels
List commits on master `BITBUCKET_LIST_COMMITS_ON_MASTER`	Lists commits on the master branch of a Bitbucket repository.	All levels
List deployments `BITBUCKET_LIST_DEPLOYMENTS`	Lists deployments for a specified Bitbucket repository.	All levels
List issues `BITBUCKET_LIST_ISSUES`	Lists issues in a Bitbucket repository with optional filtering by state, priority, kind, or assignee.	All levels
List pipelines `BITBUCKET_LIST_PIPELINES`	Find pipelines in a Bitbucket repository. Returns pipeline metadata including state, trigger, and duration. Use when you need to browse pipeline history or check pipeline status.	All levels
List pull requests `BITBUCKET_LIST_PULL_REQUESTS`	Lists pull requests in a specified, accessible Bitbucket repository, optionally filtering by state (OPEN, MERGED, DECLINED).	All levels
List pull request tasks `BITBUCKET_LIST_PULL_REQUEST_TASKS`	Lists all tasks associated with a pull request in a Bitbucket repository.	All levels
List repositories `BITBUCKET_LIST_REPOSITORIES`	Retrieves a paginated list of all public repositories on Bitbucket.	All levels
List repositories environments `BITBUCKET_LIST_REPOSITORIES_ENVIRONMENTS`	List all deployment environments configured for a Bitbucket repository.	All levels
List repositories in workspace `BITBUCKET_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.	All levels
List repository paths `BITBUCKET_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.	All levels
List snippets `BITBUCKET_LIST_SNIPPETS`	Returns all snippets accessible to the authenticated user.	All levels
List tags `BITBUCKET_LIST_TAGS`	Lists tags in a Bitbucket repository with optional server-side filtering by name pattern or commit hash (BBQL) and sorting.	All levels
List versions `BITBUCKET_LIST_VERSIONS`	Lists versions (milestones) in a Bitbucket repository's issue tracker.	All levels
List workspaces `BITBUCKET_LIST_WORKSPACES`	Lists Bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted.	All levels
List workspace members `BITBUCKET_LIST_WORKSPACE_MEMBERS`	Lists all members of a specified Bitbucket workspace; the workspace must exist.	All levels
List workspace projects `BITBUCKET_LIST_WORKSPACE_PROJECTS`	Lists projects in a specified Bitbucket workspace.	All levels
Merge pull request `BITBUCKET_MERGE_PULL_REQUEST`	Merge a Bitbucket Cloud pull request via the REST API.	Read + write, Full access
Request pull request changes `BITBUCKET_REQUEST_PULL_REQUEST_CHANGES`	Request changes on a pull request as the authenticated user.	Read + write, Full access
Resolve pull request comment `BITBUCKET_RESOLVE_PULL_REQUEST_COMMENT`	Resolve or reopen a pull request comment thread.	Read + write, Full access
Search team code `BITBUCKET_SEARCH_TEAM_CODE`	Search for code in repositories of a specified team.	All levels
Search user repositories code `BITBUCKET_SEARCH_USER_REPOSITORIES_CODE`	Search for code in the repositories of a specified user.	All levels
Update insights projects repos commits reports `BITBUCKET_UPDATE_INSIGHTS_PROJECTS_REPOS_COMMITS_REPORTS`	Create or update an insight report for a commit.	Read + write, Full access
Update issue `BITBUCKET_UPDATE_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.	Read + write, Full access
Update pull request `BITBUCKET_UPDATE_PULL_REQUEST`	Update an existing pull request's editable fields (e.g., title, description, reviewers) via the Bitbucket Cloud API.	Read + write, Full access
Update repositories commit comments `BITBUCKET_UPDATE_REPOSITORIES_COMMIT_COMMENTS`	Updates the contents of a comment on a commit.	Read + write, Full access
Update repositories commit reports annotations `BITBUCKET_UPDATE_REPOSITORIES_COMMIT_REPORTS_ANNOTATIONS`	Creates or updates an individual annotation for a commit report.	Read + write, Full access
Update teams pipelines config variables `BITBUCKET_UPDATE_TEAMS_PIPELINES_CONFIG_VARIABLES`	Updates a team-level pipeline configuration variable in Bitbucket.	Read + write, Full access
Update users pipelines config variables `BITBUCKET_UPDATE_USERS_PIPELINES_CONFIG_VARIABLES`	Updates a user-level pipeline variable for Bitbucket pipelines.	Read + write, Full access

What agents can't do in Bitbucket (yet)

Anything not in the table above. The tools mirror what Bitbucket makes available to connected apps. If Bitbucket doesn't expose an operation, agents can't perform it either.
If something you need is missing, there's usually a path: add the service's API key under Settings → Custom integrations and your agents can call it directly. See custom integrations & secrets. You can also ask your lead agent to open a ticket describing what it needs.

Using it in missions

Just ask in plain language: “check Bitbucket for …”, “create … in Bitbucket”, “every Monday, … ”, and the agent finds the right tool, runs it, and reports back with a receipt in your Runs ledger. Anything outward-facing (sending, posting, publishing) that a mission didn't clearly authorize comes back to you as a ticket first.

Troubleshooting

Agent says	What's happening	Fix
"Bitbucket isn't connected"	No active connection (or this agent is denied)	Connect on the Integrations page; check the agent's per-app policy
"The connection has expired"	Bitbucket ended the authorization (they all do periodically)	Click Reconnect on the account, same settings, one click
"I'm not allowed to do that"	The action is above the account's access level, or the agent is scoped down	Raise the level under Manage, or adjust that agent's policy
It did something unexpected	The ask was ambiguous (e.g. matched an existing item)	Be explicit, "create a NEW …", and give agents a working folder where relevant