Development

Bitbucket Integration

Work with repositories — list repos, issues, and pull requests, get an issue, and create issues, comment, or open pull requests (writes require approval).

Capabilities

This integration enables workers to:

  • List repositories
  • List issues
  • Get an issue
  • List pull requests
  • Create an issue (approval-gated)
  • Add a comment (approval-gated)
  • Create a pull request (approval-gated)

Setup

Follow these steps to connect Bitbucket:

  1. Create a Bitbucket API token (Atlassian account → Security → API tokens)
  2. Navigate to Integrations and click 'Add Connection'
  3. Select Bitbucket and enter your Atlassian account email, API token, and workspace slug
  4. Assign your engineering/operations workers to use it

Official links

Security

  • The API token is encrypted at rest (AES-256-GCM)
  • The token inherits the issuing user's access — use a least-privilege account
  • Creating issues, comments, and pull requests require human approval

Credential Storage

All integration credentials are encrypted at rest using AES-256-GCM encryption. OAuth tokens are automatically refreshed when needed.

Supported Roles

The following roles can use this integration by default:

Related Documentation