---
title: "Bitbucket integration for LuumenAI"
url: "https://www.luumen.ai/integrations/bitbucket/"
entity: SoftwareIntegration
category: "Source control & CI/CD"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Bitbucket integration for LuumenAI

Read commits, diffs, and branches in Bitbucket, then open the fix as a held write.

## What LuumenAI can do with Bitbucket

LuumenAI connects to Bitbucket with OAuth 2.0 and exposes 108 tools (78 read-only · 21 write · 9 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: OAuth 2.0
- Tools available: 108 tools (78 read-only · 21 write · 9 destructive)
- Plan: available on all plans
- Category: Source control & CI/CD

## About Bitbucket with LuumenAI

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.

## Example tools

Read-only (78 in total):

- `BITBUCKET_BROWSE_REPOSITORY_PATH` — Retrieve content for a file path or browse directory contents at a specified revision in a Bitbucket repository.
- `BITBUCKET_CREATE_REPOSITORIES_COMMITS2` — List commits from a revision using POST method.
- `BITBUCKET_GET_BRANCH` — Retrieves detailed information about a specific branch in a Bitbucket repository.
- `BITBUCKET_GET_COMMIT_BUILD_STATUS` — Get a specific build status for a commit in Bitbucket.
- `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).
- `BITBUCKET_GET_COMMIT_COMMENT` — Retrieves a specific comment from a commit by its ID.
- `BITBUCKET_GET_COMMIT_DIFF` — Retrieve the unified diff between two provided revisions or for a single commit in a Bitbucket repository.
- `BITBUCKET_GET_CURRENT_USER2` — Retrieve complete profile information for the currently authenticated Bitbucket user.

Write and destructive (30 in total, approval required by default):

- `BITBUCKET_APPROVE_PULL_REQUEST` — Approve a pull request as the authenticated user.
- `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.
- `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…
- `BITBUCKET_CREATE_ISSUE_COMMENT` — Adds a new comment with markdown support to an existing Bitbucket issue.
- `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.
- `BITBUCKET_CREATE_PULL_REQUEST_COMMENT` — Creates a new comment on a Bitbucket pull request.
- `BITBUCKET_CREATE_REPOSITORIES_COMMIT_REPORTS_ANNOTATIONS` — Adds multiple annotations to a commit report in bulk.
- `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.

## Frequently asked 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 is shown as a plan and requires approval by default, including the 9 actions classified as destructive. Administrators configure that per tool.

### 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.

Full page: https://www.luumen.ai/integrations/bitbucket/