Bitbucket Cloud Integration

Use Bitbucket Cloud integration to let Dawn discover repositories and use repository, issue, and pull request context in agent workflows.

Before you start

  • A Bitbucket Cloud account with access to the repositories Dawn should use.
  • A Bitbucket Cloud API token, recommended, or an existing legacy credential you still need to use.
  • The Bitbucket Cloud API URL, usually https://api.bitbucket.org/2.0.

The current Dawn Bitbucket provider supports Bitbucket Cloud only. Bitbucket Server and Data Center are not supported in this flow.

Bitbucket is not using Trello’s Power-Up flow. For Bitbucket Cloud, create a Bitbucket API token from your Atlassian account flow, then paste it into Dawn as email:api_token.

Create the API token

  1. Sign in to Bitbucket Cloud.
  2. Select your profile in the top-right corner, then open Account settings.
  3. On the Atlassian account page, open Security.
  4. Choose Create and manage API tokens.
  5. Click Create API token with scopes.
  6. Give the token a name like Dawn Bitbucket and choose an expiry date.
  7. Select Bitbucket as the app the token will access.
  8. Select the scopes Dawn needs, then create the token and copy it immediately.

Dawn expects your Bitbucket credential in the format email:api_token. Use the Atlassian account email for the same Bitbucket account that created the token, then add a colon and the token value.

For Dawn’s current Bitbucket features, the API token should include these read permissions:

  • read:repository:bitbucket
  • read:pullrequest:bitbucket
  • read:issue:bitbucket

Connect Bitbucket in Dawn

  1. Open Integrations in Dawn and click Add connection.
  2. Choose Bitbucket.
  3. Paste the credential into API token, bearer token, or app password as [email protected]:your_api_token.
  4. Leave API URL at the default Bitbucket Cloud API URL unless you have a specific cloud endpoint.
  5. Click Connect.
  6. Review the discovered repositories and link the sources you want available in the workspace.
  7. Assign those linked sources to the agents that should use them.

What Dawn discovers

For each discovered Bitbucket repository, Dawn creates repository, issue, and pull request sources.

Troubleshooting

  • Validation fails immediately: the provider only supports Bitbucket Cloud hosts.
  • Authentication format is unclear: for normal Bitbucket Cloud API tokens, enter the value as email:api_token. Do not paste only the raw token unless you truly have a bearer-token credential.
  • No repositories returned: the credential account likely does not have membership or access to the target workspace.
  • 403 or permission errors: the credential is missing one or more of the repository, pull request, or issue read scopes Dawn needs.
  • Still using app passwords: app passwords are legacy and Bitbucket is moving to API tokens as the replacement path. Prefer a new API token for any new Dawn setup.
Validation Prompts

Use these prompts in Dawn chat to quickly validate this setup area. 

Validate Bitbucket Cloud source connectivity and repository access.
Run a quick browse/read test against each linked Bitbucket source.
Completion Checklist
  • Bitbucket credentials valid.
  • Repository discovery returns expected results.
  • Linked repositories are readable.
  • Agent can cite Bitbucket-backed answers.