By integrating Bitbucket with DX, you can analyze pull requests, repositories, and workflow data. Please visit our schema explorer to see what data DX imports—note that DX does not read or access your source code.
Prerequisites
To connect Bitbucket to DX, you need:
if you are not on a Premium plan and can't create a Workspace Access Token, create an App Password instead
Setup instructions
Step 1
Before setting up a connection for Bitbucket, first set up a Jira connection – this is required for identification of Bitbucket users.
Step 2
If using a Workspace Access Token, create a token for DX that includes the scopes
account,pipeline,pullrequest, andrepository.If using an App Password, create an App Password for DX with all scopes set to
read.
Step 3
Navigate to the connector setup form in DX.
Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.
Note—your workspace name should be first path in the URL (i.e., it would be myworkspace given the URL below).
https://bitbucket.org/myworkspace/myrepo/src/main/
Errors
The table below lists potential error codes when adding a connection in DX.
Error | Description |
| Your API credentials entered are not valid. |
| Your API token does not have the permissions required by DX. |
| Your service account does not have access to any projects or repositories. |
Troubleshooting
I'm seeing a Token is invalid or not supported error
This typically indicates that you are using a Personal API token instead of a Workspace Access Token.