Overview
Connect Bitbucket Cloud (bitbucket.org) so AI ROI can see the pull requests your developers merge, the commits in them, and your deployments. It works the same way as the GitHub and GitLab integrations.
nOps only reads. It never writes to Bitbucket, and it never stores file contents or commit messages. Commit messages are read only to spot AI co-author markers and reverts.
nOps reads:
- Pull requests: title, author, branch, when it was opened and merged, and lines changed.
- Commits in each pull request: the commit ID and the author’s email, including commits squashed away on merge.
- Files changed: each file’s path and how many lines were added and removed.
- Deployments: which merged work reached an environment, when you use Bitbucket Deployments.
This integration targets Bitbucket Cloud only. Bitbucket Data Center and Server are not
supported yet.
What token do I need?
Bitbucket retired app passwords. Use one of these instead:
Give the token these read scopes:
For a workspace access token, choose the matching read permissions: Repositories: Read, Pull requests: Read, and optionally Pipelines: Read.
Only nOps admins and owners can connect, re-validate, or disconnect. Members see
Admin Only on connectable cards.
Create the token
API token with scopes (recommended)
- Sign in to your Atlassian account and open Account settings → Security → Create and manage API tokens.
- Choose Create API token with scopes, name it (for example
nOps AI ROI), and set an expiry date. - Select Bitbucket as the app, then select the scopes in the table above.
- Create the token and copy it. It is shown only once.
Workspace access token (Premium)
- In Bitbucket, open your workspace’s Settings → Access tokens.
- Create a token with the read permissions above.
- Copy the token. It is shown only once.
Connect in nOps
- Go to Settings → Integrations and open Bitbucket.
- Enter your workspace ID: the
acmeinbitbucket.org/acme. - For an API token, enter the Atlassian account email that created it. For a workspace access token, leave the email blank.
- Paste the token and click Connect.
After connecting
Pull requests appear in AI ROI after the next daily refresh. To have the Clara developer agent record work in your Bitbucket repositories too, add the workspace to the agent’s allowlist asbitbucket.org/<workspace> in Settings → Integrations → AI ROI agent → Policy.