> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# What is the Maia Bitbucket App?

export const maia_0 = undefined

export const maia = "Maia";

<Info>
  This feature is available to customers on specific editions. Visit the {maia_0} [Pricing](https://www.maia.ai/pricing) page to learn more about each edition.
</Info>

The {maia} Bitbucket App, or more specifically OAuth Consumer, is a native solution to let {maia} users connect their Bitbucket repositories to their {maia} projects. The app solution provides high security by implementing the principle of least privilege (PoLP), meaning that the application requests only the permissions required to function, and nothing else. In the case of Bitbucket, the app can only interact with repositories, and see necessary information about the individual user. These requested permissions then allow {maia} to store and retrieve data pipelines corresponding to the Bitbucket account of the particular user.

There are no installation steps for the {maia} Bitbucket application. However, you will be prompted to authorize that the application can access your account to act upon your behalf.

If, for any reason, you wish to stop {maia} from accessing your Bitbucket repositories, you can easily revoke access. To do this, follow the instructions in the [Revoke App Authorization from a Bitbucket Account](https://support.atlassian.com/bitbucket-cloud/kb/revoke-app-authorization-from-a-bitbucket-account/) documentation.

You can read more about [Bitbucket OAuth Consumers](https://support.atlassian.com/bitbucket-cloud/docs/use-oauth-on-bitbucket-cloud/) in the Atlassian Bitbucket documentation.

***

## Video example

<iframe width="560" height="315" src="https://www.youtube.com/embed/lbPZBU6mClk?si=tjM20iLsjqwoGYo3&enablejsapi=1" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share; fullscreen" referrerPolicy="strict-origin-when-cross-origin" allowFullScreen />

***

## How authorization works

Authorization happens the first time you connect a Bitbucket repository during the project creation flow in {maia}:

1. During project creation, choose **Advanced settings** from the **Select project configuration** page.
2. On the **Select Git provider** page, select **Bitbucket**.
3. {maia} detects whether you've authorized before. If not, click **Authorize**.
4. You're redirected to Bitbucket. Review the requested permissions, then click **Grant access** to allow the application to access your account.
5. Once authorized, you're returned to {maia} to continue setting up your project.

<Note>
  Authorization is per user and only required once. After that, {maia} can access any Bitbucket repository your account has permission to write to, across any project you create.
</Note>

For the complete project creation flow, see [Projects](/docs/guides/projects#select-your-git-provider).

***

## Related pages

* [Prerequisites for connecting a Bitbucket repository to {maia}](/docs/guides/connect-bitbucket-repository-prerequisites)
* [Troubleshooting Bitbucket repository connections](/docs/guides/troubleshooting-bitbucket-repository-connection)