Bitbucket

About Bitbucket

Bitbucket Cloud provides a REST API and app development platform for integrating with and extending Bitbucket. Developers can call the REST API directly via scripts or API clients to automate operations on Bitbucket entities such as commits and pull requests, or build apps using Forge, Atlassian's recommended platform for creating apps that integrate with external services, add features, or retrieve and update Bitbucket information. Apps can also be built as pipes for Bitbucket Pipelines to integrate with external systems for code deployment, scanning, or other functionality.

Authentication options include OAuth 2.0 (3LO) for apps built outside Forge, basic auth via API tokens and Access Tokens, and managed OAuth 2.0 handled by the Forge platform itself, which avoids exposing user credentials to third-party code. Certain Bitbucket features, such as custom merge checks, dynamic pipeline providers, and the project settings menu page, are only available to apps built on Forge.

The documentation is aimed at developers building integrations, apps, or automation tools for Bitbucket Cloud. It includes guidance on Atlassian's design guidelines and UI component libraries (UI Kit, Atlaskit) for apps that insert content into the interface, along with information on publishing Connect apps to the Atlassian Marketplace, either publicly or as private listings using self-generated secret tokens.

Key features

• REST API for accessing and updating Bitbucket entities like commits and pull requests
• Forge platform for building secure, reliable, and scalable apps
• OAuth 2.0 (3LO) and basic auth support for API authentication
• Bitbucket Pipelines pipes for integrating external systems
• Custom merge checks, dynamic pipeline provider, and project settings menu page for Forge apps

Frequently asked questions