BitBucket Cloud is a source code version control repository hosting service owned by Atlassian. You can use the available tools to manage source code for a project with an exclusive built-in CI/CD tool and Pipelines that enables you to build, test, and deploy your applications directly within the BitBucket Cloud.
The following tables describe the properties used to configure the integration. Each table contains the field name when using the user interface and the property name when using a JSON file.
Configuration Properties
Usage
Summary
properties configuration property.Not all configuration properties are initially displayed in the user interface, to see all properties enable the Hidden field.
| Name | Description | Required | Property Name |
|---|---|---|---|
| Integration Name | The name of the integration. | Yes | name |
| Logging Level | The level of Log4j messages to display in the log file. Valid values are: all, debug, info, warn, error, fatal, off, and trace. | No | loggingLevel |
| properties | List of plug-in configuration properties used to connect and communicate with the BitBucket Cloud. Enclose the properties within braces. | Yes | properties |
| Tenant id | The name of the tenant. | Yes | tenant_id |
| Type | Unique identifier assigned to the plug-in. The value for the BitBucket Cloud plugin is ucv-ext-bitBucket-cloud |
Yes | type |
| Name | Type | Description | Required | Property Name |
|---|---|---|---|---|
| Base API URL | String | The base URL of BitBucket Cloud API. URL is https://api.bitbucket.org/2.0 | Yes | baseUrl |
| Username | String | The username must be an Atlassian account email. | Yes | username |
| API Token | Secure | The API token to authenticate with BitBucket cloud. To generate a token, see: https://support.atlassian.com/bitbucket-cloud/docs/create-an-api-token/. This field is applicable only for version 1.0.37 or later | Yes | password |
| App Password | Secure | Use your API token as the password. To generate a token, see: https://support.atlassian.com/bitbucket-cloud/docs/create-an-api-token/. This field is applicable only for version 1.0.36 or earlier. | Yes | password |
| Project Key | String | The repository project key. | Yes | projectKey |
| Repository Name | Array | The comma separated name of the repositories | Yes | repositoryName |
| API Limits | String | Maximum API calls that the plug-in makes in a single run. | No | apiLimits |
| Branch Name | String | The branch to pull changes from. | No | branchName |
| Additional Branches | Array | Comma seperated names of additional branches to collect commits from besides the main one, leave blank if not needed. | No | otherBranches |
| Proxy Password | Secure | The password used to authenticate with the proxy server. | No | proxyPassword |
| Proxy Server | String | The URL of the proxy server including the port number. The URL protocol can be http or https. | No | proxyServer |
| Proxy User Name | String | The user name used to authenticate with the proxy server. | No | proxyUsername |
The following sample code can be used as a template to define the integration within the JSON file for a value stream. Copy and paste the template into the JSON file Integration section and make the appropriate changes.
{
"type": "ucv-ext-bitbucket-cloud",
"tenant_id": "5ade13625558f2c6688d15ce",
"name": "my-bitbucket",
"loggingLevel": "info",
"disabled": false,
"properties": {
"baseUrl": "[Base URL https://api.bitbucket.org/2.0]",
"username": "[Atlassian account email address]",
"password": "[API token created with scope]",
"projectKey": "[Project key ex: SAM]",
"repositoryName": "[repository name ex: sample]"
}
}
To use the BitBucket Cloud plug-in, the plug-in must be loaded and an instance created before you can configure the plug-in integration. You define configuration properties in the user interface or in a JSON file.
The BitBucket Cloud plug-in supports scheduled events integration which is listed in the following table.
| Name | Description |
|---|---|
| syncBitbucketPullRequestsEvent | Queries the BitBucket Cloud for pull requests in a project. |
| syncBitbucketCommitsEvent | Queries the BitBucket Cloud for commits in a project. |
There are two methods to integrate the plugin:
The JSON file contains the information for creating a value stream and integrating with the BitBucket Cloud. The following table describes the information for creating a DevOps Velocity value stream map.
The BitBucket Cloud plug-in provides for integration with a BitBucket Cloud.
This plug-in requires DevOps Velocity 2.5.0 or later.
Uploaded: 02-Jan-2026 04:43
Uploaded: 19-Dec-2025 10:36
Uploaded: 27-Dec-2022 12:00
docker pull hclcr.io/accelerate/ucv-ext-bitbucket-cloud:1.0.29
Uploaded: 23-Sep-2022 11:02
docker pull hclcr.io/accelerate/ucv-ext-bitbucket-cloud:1.0.26
Uploaded: 07-Jun-2022 03:59
docker pull hclcr.io/accelerate/ucv-ext-bitbucket-cloud:1.0.22
Uploaded: 25-Mar-2022 13:38
docker pull hclcr.io/accelerate/ucv-ext-bitbucket-cloud:1.0.16
Uploaded: 23-Feb-2022 07:14
docker pull hclcr.io/accelerate/ucv-ext-bitbucket-cloud:1.0.15
Uploaded: 09-Aug-2021 06:32
docker pull hclcr.io/accelerate/ucv-ext-bitbucket-cloud:1.0.8
Uploaded: 26-May-2021 13:56
docker pull hclcr.io/accelerate/ucv-ext-bitbucket-cloud:1.0.7
