Skip to content

Source code

Connect a Bitbucket Cloud workspace so Dave can read code and open pull requests.

Bitbucket asks for your workspace before sending you to approve Dave. Only Bitbucket Cloud is supported.

  1. Find your workspace ID — the segment after bitbucket.org/ in your repository URLs. For https://bitbucket.org/acme/api, that is acme.

  2. In Dave, go to Integrations → Add integration → Bitbucket.

  3. Enter the Workspace, then choose Continue to Bitbucket.

  4. Sign in as a member of that workspace and grant Dave access.

A workspace can be connected to only one Dave workspace at a time.

Dave connects over OAuth. Bitbucket shows the access it asks for on the approval screen:

account
repository:write
pullrequest:write

Dave acts as the Bitbucket account that approved it, so it reads code, pushes branches, opens pull requests, and comments on them with that account’s access. The account must be a member of the workspace. Dave checks this when you connect. Workspace admin rights are not required.

To limit what Dave can reach, approve with a dedicated Bitbucket account that has access to only the repositories Dave should work in.

The account that approved Dave can review or revoke it under Personal settings → App authorizations (avatar → Personal settings).

Disconnect in Dave deletes Dave’s stored token, but it does not revoke the authorization on Bitbucket. To fully revoke Dave, the approving account should also choose Revoke next to Dave under App authorizations.

If the approving account leaves the workspace or revokes Dave, the connection stops working. Connect again with another member.

After connecting, choose which repositories Dave should work in. This narrows Dave’s attention; it does not change what the approving account can access.

  • “The Bitbucket account that approved Dave is not a member of this workspace.” Check the workspace ID, then Connect again signed in as a member of it.
  • “This Bitbucket workspace is already connected to another Dave workspace.” Disconnect it there first.
  • “Bitbucket authorization could not be completed.” The popup was closed, or Bitbucket refused the approval. Connect again.