Bitbucket
for LuumenAI
Read commits, diffs, and branches in Bitbucket, then open the fix as a held write.
Connect Bitbucket and Luumen can read your repositories the way you would during an incident: file contents at a given revision, commit diffs, branch state, and build status on a commit. When it is time to change something — a branch, a pull request, an issue, a comment — the agent shows the exact call first and waits for your approval. Auth is OAuth2.
The Bitbucket toolbox
108 tools: 78 read, 30 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadBrowse repository pathRetrieve content for a file path or browse directory contents at a specified revision in a Bitbucket repository.
- ReadList commits from revision (POST)List commits from a revision using POST method.
- ReadGet branchRetrieves detailed information about a specific branch in a Bitbucket repository.
- ReadGet Commit Build StatusGet a specific build status for a commit in Bitbucket.
- ReadGet Commit ChangesRetrieve a page of changes made in a specified commit, showing all changed files with their change statistics (lines added/removed, status).
- ReadGet commit commentRetrieves a specific comment from a commit by its ID.
- ReadGet Commit DiffRetrieve the unified diff between two provided revisions or for a single commit in a Bitbucket repository.
- ReadGet current user (v2)Retrieve complete profile information for the currently authenticated Bitbucket user.
- ReadGet deployment environment variablesRetrieves deployment environment level variables for a specific Bitbucket repository environment.
- ReadGet file from repositoryRetrieves 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.
- ReadGet hook eventsRetrieves a paginated list of all valid webhook events for a specified entity type (repository or workspace).
- ReadGet OpenID configuration for OIDC in PipelinesRetrieves the OpenID Connect discovery configuration for Bitbucket Pipelines OIDC.
- ReadGet Pull RequestGet a single pull request by ID with complete details.
- ReadGet pull request commentRetrieve a specific comment from a pull request by its ID.
- ReadGet Pull Request CommitsRetrieve commits for a specified pull request.
- ReadGet Pull Request DiffFetch the unified diff for a Bitbucket pull request (follows 302 redirect to repository diff).
- ReadGet Pull Request DiffstatGet the diffstat for a Bitbucket pull request, showing all changed files with their change statistics (lines added/removed, status).
- ReadGet Repository Branching ModelReturn the branching model as applied to the repository.
- ReadGet Repository CommitRetrieve detailed information about a specific commit in a Bitbucket repository.
- ReadGet commit commentsRetrieves all comments on a specific commit in a Bitbucket repository.
- ReadGet commit reportReturns a single report matching the provided ID from a commit.
- ReadGet Commit ReportsGet reports linked to a specific commit.
- ReadGet commit report annotationReturns a single annotation matching the provided ID from a commit report.
- ReadGet commit statusesReturns all build statuses (e.g., CI/CD pipeline results) for a specific commit.
- ReadGet effective branching modelRetrieves the effective branching model for a Bitbucket repository, showing which branching model is currently applied (including any inheritance from project-level settings).
- ReadGet Repository EnvironmentRetrieve detailed information about a specific deployment environment in a Bitbucket repository.
- ReadGet file commit historyReturns a paginated list of commits that modified the specified file.
- ReadCheck if user voted for issueCheck whether the authenticated user has voted for a specific issue in a Bitbucket repository.
- ReadGet Repositories Merge BaseGet the merge base (best common ancestor) between two commits in a Bitbucket repository.
- ReadGet specific pipelineRetrieve a specified pipeline from a Bitbucket repository.
- ReadGet repository pipelines cachesRetrieves the repository pipelines caches.
- ReadGet repository pipeline runnersRetrieves the list of self-hosted runners configured for a repository's pipelines.
- ReadGet repository pipeline schedulesRetrieves configured pipeline schedules for a Bitbucket repository.
- ReadGet repository SSH known hostsRetrieves repository-level SSH known hosts configured for Bitbucket Pipelines.
- ReadGet repository pipeline variablesRetrieves repository-level pipeline variables for a specific Bitbucket repository.
- ReadGet pipeline stepsRetrieves all steps for a given pipeline.
- ReadGet pull requests activity logGet paginated activity log for all pull requests in a repository.
- ReadGet pull request commentsRetrieves a paginated list of comments on a specific pull request in a Bitbucket repository.
- ReadGet pull request statusesReturns all build statuses (e.g., CI/CD pipeline results) for a specific pull request.
- ReadGet repository refsReturns the branches and tags in the repository.
- ReadGet tagRetrieves detailed information about a specific tag in a Bitbucket repository.
- ReadGet repositories srcLists the contents of the root directory on the repository's main branch without needing to specify a commit or branch.
- ReadGet repository watchersRetrieves a paginated list of all the watchers on the specified repository.
- ReadGet repositoryRetrieves detailed information about a specific repository in a Bitbucket workspace.
- ReadGet Repository PatchRetrieve the git patch content for a Bitbucket repository at a specified revision or commit range.
- ReadGet snippetRetrieves a specific Bitbucket snippet by its encoded ID from an existing workspace, returning its metadata and file structure.
- ReadGet snippet watch statusChecks if the current user is watching a specific snippet.
- ReadGet SSH keys for userRetrieves a paginated list of SSH keys for a specified Bitbucket user.
- ReadGet userRetrieves public profile information for a specific Bitbucket user by username or UUID.
- ReadGet user emailsReturns all the authenticated user's email addresses, both confirmed and unconfirmed.
- ReadGet user email detailsRetrieves details about a specific email address for the authenticated user.
- ReadGet user permissions for repositoriesReturns an object for each repository the caller has explicit access to, including their permission level.
- ReadGet user permissions for workspacesRetrieves workspace memberships and permission levels for the authenticated user.
- ReadGet user workspacesRetrieve all workspaces accessible to the authenticated user.
- ReadGet workspaceRetrieves detailed information about a specific Bitbucket workspace.
- ReadGet Workspace Pull Requests by UserGet all workspace pull requests authored by a specified user.
- ReadSearch code in workspaceSearch for code in the repositories of the specified workspace.
- ReadList branchesLists branches in a Bitbucket repository with optional server-side filtering by name pattern (BBQL) and sorting.
- ReadList commitsRetrieve a page of commits from a Bitbucket repository.
- ReadList commits from revisionList commits starting from a specific revision in a Bitbucket repository.
- ReadList commits on masterLists commits on the master branch of a Bitbucket repository.
- ReadList deploymentsLists deployments for a specified Bitbucket repository.
- ReadList issues in a repositoryLists issues in a Bitbucket repository with optional filtering by state, priority, kind, or assignee.
- ReadList pipelinesFind pipelines in a Bitbucket repository.
- ReadList pull requestsLists pull requests in a specified, accessible Bitbucket repository, optionally filtering by state (OPEN, MERGED, DECLINED).
- ReadList pull request tasksLists all tasks associated with a pull request in a Bitbucket repository.
- ReadList all public repositoriesRetrieves a paginated list of all public repositories on Bitbucket.
- ReadList repository environmentsList all deployment environments configured for a Bitbucket repository.
- ReadList repositories in workspaceLists repositories in a specified Bitbucket workspace, accessible to the authenticated user, with options to filter by role or query string, and sort results.
- ReadList repository forksRetrieves a paginated list of all forks for a specific repository in a Bitbucket workspace.
- ReadList repository pathsLists 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.
- ReadList snippetsReturns all snippets accessible to the authenticated user.
- ReadList tagsLists tags in a Bitbucket repository with optional server-side filtering by name pattern or commit hash (BBQL) and sorting.
- ReadList versionsLists versions (milestones) in a Bitbucket repository's issue tracker.
- ReadList workspace membersLists all members of a specified Bitbucket workspace; the workspace must exist.
- ReadList workspace projectsLists projects in a specified Bitbucket workspace.
- ReadList workspacesLists Bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted.
- ReadSearch code in user repositoriesSearch for code in the repositories of a specified user.
- WriteApprove Pull RequestApprove a pull request as the authenticated user. Approval by default
- WriteCreate a branchCreates 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. Approval by default
- WriteCreate an issueCreates 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… Approval by default
- WriteCreate an issue commentAdds a new comment with markdown support to an existing Bitbucket issue. Approval by default
- WriteCreate a pull requestCreates a new pull request in a specified Bitbucket repository, ensuring the source branch exists and is distinct from the (optional) destination branch. Approval by default
- WriteCreate pull request commentCreates a new comment on a Bitbucket pull request. Approval by default
- WriteCreate commit report annotationsAdds multiple annotations to a commit report in bulk. Approval by default
- WriteCreate repositoryCreates a new Bitbucket 'git' repository in a specified workspace, defaulting to the workspace's oldest project if `project_key` is not provided. Approval by default
- WriteCreate snippet commentPosts a new top-level comment or a threaded reply to an existing comment on a specified Bitbucket snippet. Approval by default
- WriteCreate team pipeline variableCreates a team-level pipeline configuration variable in Bitbucket. Approval by default
- WriteCreate user pipeline variableCreates a user-level pipeline variable for Bitbucket pipelines. Approval by default
- WriteDecline Pull RequestDecline a Bitbucket Cloud pull request via the REST API. Approval by default
- WriteDelete commit commentPermanently deletes a specific comment on a commit. Approval by default
- WriteDelete issuePermanently deletes a specific issue, identified by its `issue_id`, from the repository specified by `repo_slug` within the given `workspace`. Approval by default
- WriteDelete pull request commentPermanently deletes a specific pull request comment (top-level, inline, or threaded reply). Approval by default
- WriteDelete commit report annotationDeletes a single annotation matching the provided ID from a commit report. Approval by default
- WriteDelete repositoryPermanently deletes a specified Bitbucket repository; this action is irreversible and does not affect forks. Approval by default
- WriteDelete snippet watchStops watching a specific snippet. Approval by default
- WriteDelete user pipeline variablePermanently deletes a user-level pipeline configuration variable identified by its UUID. Approval by default
- WriteMerge Pull RequestMerge a Bitbucket Cloud pull request via the REST API. Approval by default
- WriteRequest Pull Request ChangesRequest changes on a pull request as the authenticated user. Approval by default
- WriteResolve pull request commentResolve or reopen a pull request comment thread. Approval by default
- WriteStop pipelineSignal the stop of a pipeline and all of its steps that have not completed yet. Approval by default
- WriteUpdate commit insight reportCreate or update an insight report for a commit. Approval by default
- WriteUpdate an issueUpdates an existing issue in a Bitbucket repository by modifying specified attributes; requires `workspace`, `repo_slug`, `issue_id`, and at least one attribute to update. Approval by default
- WriteUpdate Pull RequestUpdate an existing pull request's editable fields (e.g., title, description, reviewers) via the Bitbucket Cloud API. Approval by default
- WriteUpdate commit commentUpdates the contents of a comment on a commit. Approval by default
- WriteUpdate commit report annotationCreates or updates an individual annotation for a commit report. Approval by default
- WriteUpdate team pipeline variableUpdates a team-level pipeline configuration variable in Bitbucket. Approval by default
- WriteUpdate user pipeline variableUpdates a user-level pipeline variable for Bitbucket pipelines. Approval by default
One prompt, start to finish
What a governed Bitbucket run looks like inside Luumen.
Questions
How does LuumenAI connect to Bitbucket?
Authorize once with OAuth 2.0. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in Bitbucket on its own?
Read actions answer immediately. Anything that writes — approve pull request, create a branch, create an issue, create an issue comment, and more — is shown as a plan and requires approval by default, including the 9 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to Bitbucket — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
Put Bitbucket to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.