Bitbucket

​

Prerequisites

• Bitbucket Cloud account
• App password with repository read access

​

Setup

​

Option 1: Interactive CLI

healops integrations setup

​

Option 2: Environment variables

BITBUCKET_WORKSPACE=your-workspace-slug
BITBUCKET_USERNAME=your-username
BITBUCKET_APP_PASSWORD=your-app-password

​

Option 3: Persistent store

{
  "version": 1,
  "integrations": [
    {
      "id": "bitbucket-prod",
      "service": "bitbucket",
      "status": "active",
      "credentials": {
        "workspace": "your-workspace-slug",
        "username": "your-username",
        "app_password": "your-app-password"
      }
    }
  ]
}

​

Creating an app password

1. In Bitbucket, go to Personal settings → App passwords
2. Click Create app password
3. Give it a label (e.g., healops)
4. Enable the following permissions: Repositories: Read
5. Copy the generated password

​

Investigation tools

• Commits — retrieves recent commits for a repository, optionally filtered by file path
• File contents — fetches the contents of a file at a specific revision
• Code search — searches code across the workspace or a specific repository

​

Verify

healops integrations verify bitbucket

Service: bitbucket
Status: passed
Detail: Authenticated as Your Name; workspace: your-workspace

​

Troubleshooting

​

Security best practices

• Use an app password rather than your account password — app passwords can be revoked individually.
• Scope permissions to Repositories: Read only.
• Store credentials in .env, not in source code.