Developer
News and Updates
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Last updated Jun 18, 2026

Changelog

This changelog is the source of truth for all changes to the Bitbucket API and Bitbucket Connect API that affect people using Bitbucket Cloud and developing Bitbucket Cloud apps.

To ask any questions related to Bitbucket Cloud development please visit the Bitbucket Cloud developer community.

18 June 2026

Deprecation Notice Removal of Public REST APIs related to Connect application properties

As part of end of support for Connect app, we will be deprecating application property APIs.

When we reach Connect EOL, the following endpoints will be removed:

  1. GET /repositories/{workspace}/{repo_slug}/commit/{commit}/properties/{app_key}/{property_name}

  2. PUT /repositories/{workspace}/{repo_slug}/commit/{commit}/properties/{app_key}/{property_name}

  3. DEL /repositories/{workspace}/{repo_slug}/commit/{commit}/properties/{app_key}/{property_name}

  4. GET /repositories/{workspace}/{repo_slug}/properties/{app_key}/{property_name}

  5. PUT /repositories/{workspace}/{repo_slug}/properties/{app_key}/{property_name}

  6. DEL /repositories/{workspace}/{repo_slug}/properties/{app_key}/{property_name}

  7. GET /repositories/{workspace}/{repo_slug}/pullrequests/{pullrequest_id}/properties/{app_key}/{property_name}

  8. PUT /repositories/{workspace}/{repo_slug}/pullrequests/{pullrequest_id}/properties/{app_key}/{property_name}

  9. DEL /repositories/{workspace}/{repo_slug}/pullrequests/{pullrequest_id}/properties/{app_key}/{property_name}

  10. GET /users/{selected_user}/properties/{app_key}/{property_name}

  11. PUT /users/{selected_user}/properties/{app_key}/{property_name}

  12. DEL /users/{selected_user}/properties/{app_key}/{property_name}

Announcement Partner Security Incident Response Program

We've introduced a structured process for partners and Atlassian to jointly investigate security incidents affecting your app or the customer data it handles.

What's changing

  • Log sharing for Forge apps: Atlassian can now share incident-scoped platform logs and app telemetry with you during an investigation. This provides the data you need to diagnose and resolve issues faster.

  • A single reporting path: You can now report security incidents through the new developer support portal form. This form serves as the shared record for both you and Atlassian.

What you need to do

  • Review the program overview page to understand eligibility and support levels.

  • Ensure your security contact information is up to date in the partner account to ensure you are ready before an incident occurs.

16 June 2026

Removed Connect addon linker APIs removed

As announced in Feb 5, 2026, we have removed the Bitbucket Cloud Connect addon linker APIs. These endpoints are no longer available.

What’s changing

The following REST API endpoints have been removed from Bitbucket Cloud:

  • GET /2.0/addon/linkers

  • GET /2.0/addon/linkers/{linker_key}

  • GET /2.0/addon/linkers/{linker_key}/values

  • PUT /2.0/addon/linkers/{linker_key}/values

  • POST /2.0/addon/linkers/{linker_key}/values

  • DEL /2.0/addon/linkers/{linker_key}/values

  • GET /2.0/addon/linkers/{linker_key}/values/{value_id}

What you need to do

If you were using these endpoints, you must update your integrations to remove these calls as they will now return an error. For more information on the end of support for Connect on Bitbucket Cloud, please refer to the official announcement.

10 June 2026

Added New Bitbucket navigation targets for Forge bridge router

We’ve added new navigation targets for the Forge bridge’s router object. These allow you to use the router API to navigate to supported UI module pages in Bitbucket.

What’s changing:

The following Bitbucket modules are now supported as navigation targets:

  • bitbucket:workspaceGlobalPage

  • bitbucket:workspacePersonalSettingsPage

  • bitbucket:workspaceSettingsMenuPage

  • bitbucket:projectSettingsMenuPage

  • bitbucket:repoMainMenuPage

  • bitbucket:repoSettingsMenuPage

What you need to do:

You can now update your Custom UI or UI Kit apps to use these targets with router methods. For implementation details and examples, see the router object documentation.

29 May 2026

Deprecation Notice Brownout Notice: App password deprecation for Bitbucket Cloud

Bitbucket Cloud is transitioning to API tokens to enhance security. As part of this transition, app passwords will be fully deprecated on Jul 28, 2026. To help you identify and migrate any remaining usage before the final removal, we are running a series of controlled brownouts starting Jun 9, 2026.

What’s changing:

During each brownout window, API requests authenticated using app passwords will fail with an HTTP 401 while Git-over-HTTPS operations authenticated using app passwords will fail with an HTTP 410.

What you need to do:
You must migrate to API tokens before Jul 28, 2026. API tokens offer improved security, expiration controls, and centralized management.

To create and use an API token:

  1. Select your Profile icon, then select Account settings.

  2. Select Security, then Create and manage API tokens, and then select Create API token.

  3. Select Create API token with scopes.

  4. Name the token, set an expiry date, select Bitbucket as the app.

  5. Assign the necessary scopes and save the token.

  6. Update your integration credentials, CI/CD pipelines, and local Git configurations with the new API token.

For detailed guidance, see the API token documentation.

More details

Dates

Brownout duration per window

Brownout window start times (UTC)

Jun 09, 2026

15 minutes

00:00, 06:00, 12:00, 18:00

Jun 10, 2026

15 minutes

00:00, 06:00, 12:00, 18:00

Jun 11, 2026

15 minutes

00:00, 06:00, 12:00, 18:00

Jun 12, 2026

15 minutes

00:00, 06:00, 12:00, 18:00

Jun 13, 2026

15 minutes

00:00, 06:00, 12:00, 18:00

Jun 14, 2026

15 minutes

00:00, 06:00, 12:00, 18:00

Jun 15, 2026

15 minutes

00:00, 06:00, 12:00, 18:00

Jun 16, 2026

30 minutes

00:00, 06:00, 12:00, 18:00

Jun 17, 2026

30 minutes

00:00, 06:00, 12:00, 18:00

Jun 18, 2026

30 minutes

00:00, 06:00, 12:00, 18:00

Jun 19, 2026

30 minutes

00:00, 06:00, 12:00, 18:00

Jun 20, 2026

30 minutes

00:00, 06:00, 12:00, 18:00

Jun 21, 2026

30 minutes

00:00, 06:00, 12:00, 18:00

Jun 22, 2026

30 minutes

00:00, 06:00, 12:00, 18:00

Jun 23, 2026

1 hour

00:00, 06:00, 12:00, 18:00

Jun 24, 2026

1 hour

00:00, 06:00, 12:00, 18:00

Jun 25, 2026

1 hour

00:00, 06:00, 12:00, 18:00

Jun 26, 2026

1 hour

00:00, 06:00, 12:00, 18:00

Jun 27, 2026

1 hour

00:00, 06:00, 12:00, 18:00

Jun 28, 2026

1 hour

00:00, 06:00, 12:00, 18:00

Jun 29, 2026

1 hour

00:00, 06:00, 12:00, 18:00

Jun 30, 2026

2 hours

00:00, 06:00, 12:00, 18:00

Jul 01, 2026

2 hours

00:00, 06:00, 12:00, 18:00

Jul 02, 2026

2 hours

00:00, 06:00, 12:00, 18:00

Jul 03, 2026

2 hours

00:00, 06:00, 12:00, 18:00

Jul 04, 2026

2 hours

00:00, 06:00, 12:00, 18:00

Jul 05, 2026

2 hours

00:00, 06:00, 12:00, 18:00

Jul 06, 2026

2 hours

00:00, 06:00, 12:00, 18:00

Jul 07, 2026

3 hours

00:00, 06:00, 12:00, 18:00

Jul 08, 2026

3 hours

00:00, 06:00, 12:00, 18:00

Jul 09, 2026

3 hours

00:00, 06:00, 12:00, 18:00

Jul 10, 2026

3 hours

00:00, 06:00, 12:00, 18:00

Jul 11, 2026

3 hours

00:00, 06:00, 12:00, 18:00

Jul 12, 2026

3 hours

00:00, 06:00, 12:00, 18:00

Jul 13, 2026

3 hours

00:00, 06:00, 12:00, 18:00

Jul 14, 2026

4 hours

00:00, 06:00, 12:00, 18:00

Jul 15, 2026

4 hours

00:00, 06:00, 12:00, 18:00

Jul 16, 2026

4 hours

00:00, 06:00, 12:00, 18:00

Jul 17, 2026

4 hours

00:00, 06:00, 12:00, 18:00

Jul 18, 2026

4 hours

00:00, 06:00, 12:00, 18:00

Jul 19, 2026

4 hours

00:00, 06:00, 12:00, 18:00

Jul 20, 2026

4 hours

00:00, 06:00, 12:00, 18:00

Jul 21, 2026

5 hours

00:00, 06:00, 12:00, 18:00

Jul 22, 2026

5 hours

00:00, 06:00, 12:00, 18:00

Jul 23, 2026

5 hours

00:00, 06:00, 12:00, 18:00

Jul 24, 2026

5 hours

00:00, 06:00, 12:00, 18:00

Jul 25, 2026

5 hours

00:00, 06:00, 12:00, 18:00

Jul 26, 2026

5 hours

00:00, 06:00, 12:00, 18:00

Jul 27, 2026

5 hours

00:00, 06:00, 12:00, 18:00

Jul 28, 2026

Final removal

 

28 May 2026

Announcement Raising the bar on Marketplace security: Updated cloud app SLOs and new enforcement policy

As recently announced in Raising the bar on Marketplace cloud app security: together we are updating the Marketplace Security Bug Fix Policy to shorten vulnerability remediation timelines for Marketplace cloud apps. These changes ensure a higher security standard across our ecosystem.

What’s changing
The remediation Service Level Objectives (SLOs) for Marketplace cloud apps are being shortened. The timelines for Data Center apps remain unchanged.

Updated Cloud App SLOs (Enforceable September 1, 2026):

  • Critical: 10 days

  • High: 4 weeks

  • Medium: 12 weeks

  • Low: 25 weeks

Data Center App SLOs (Unchanged):

  • Critical: 12 weeks

  • High: 12 weeks

  • Medium: 12 weeks

  • Low: 25 weeks

Additionally, we have published the Marketplace Security Enforcement Policy, a consolidated source of truth for marketplace security compliance expectations, including vulnerability management, OAuth compliance, partner verification, bug bounty participation, and incident response.

What you need to do

  • Review the new timelines: Ensure your internal processes are updated to meet the new cloud app SLOs by September 1, 2026.

  • Check your tickets: We have corrected an issue where some AMS Data Center tickets incorrectly showed cloud remediation dates. If you believe a ticket still has an incorrect date, please raise an ECOHELP ticket.

  • Watch the policy page: The Marketplace Security Enforcement Policy is a living document, we recommend "watching" the page for future updates.

25 May 2026

Added Tile component is now available in Preview for Forge UI Kit

We've introduced the Tile component for Forge UI Kit apps, now available in Preview. The Tile component is a rounded square container for displaying assets like emojis, or objects in a consistent, styled way.

The component supports various sizes (from 16px to 48px), customizable background colors using design tokens, optional borders, and adjustable internal padding for different asset types including third-party logos.

For implementation details and examples, see the Tile component documentation.

12 May 2026

Deprecation Notice SSH access via bitbucket.org is deprecated in favor of ssh.bitbucket.org

SSH access to Bitbucket Cloud repositories via bitbucket.org will be removed after approximately six months. SSH traffic is being separated from HTTPS traffic to enable enhanced security protections on Bitbucket's public web and API endpoints.

Customers who use Git over SSH must update their remote URLs to use ssh.bitbucket.org instead of bitbucket.org. HTTPS access to bitbucket.org is not affected by this change.

More details

What is changing

Bitbucket Cloud is splitting HTTPS and SSH traffic so that bitbucket.org will serve only HTTPS requests. All SSH-based Git operations (clone, push, pull, fetch) must use the new ssh.bitbucket.org hostname.

Migration steps

  1. For each repository using an SSH remote, update the remote URL:

    1 git remote set-url origin git@ssh.bitbucket.org:<workspace>/<repo>.git
  2. On first connection to ssh.bitbucket.org, verify and accept the new host key when prompted, or pre-add it to ~/.ssh/known_hosts.

  3. Update any CI/CD pipelines, deployment scripts, or automation that use SSH to clone or push to bitbucket.org.

  4. If your network restricts outbound SSH connections via firewall rules, ensure ssh.bitbucket.org on port 22 is allowlisted.

More details are captured in this community blogpost.

Timeline

Customers will have approximately six months from the announcement date to complete the migration. After the migration period ends, SSH connections to bitbucket.org will be refused.

Announcement Skip CI feature update in Bitbucket Pipelines

To maintain system stability as our usage scales, we updated Bitbucket Pipelines to only detect the [skip ci] or [ci skip] label within the first 200 characters of a commit message. This means pipelines won’t be skipped if the label appears further in a long message.

To ensure your builds are intentionally skipped, place the label near the start of your commit message, ideally in the subject line. Manual runs are not affected by this change.

For details, read
https://support.atlassian.com/bitbucket-cloud/kb/how-to-skip-triggering-an-automatic-pipeline-build-using-skip-ci-label/.

3 May 2026

Added Bitbucket Connect → Forge migration tooling: new addon clientKey endpoint

What’s changing
We’ve introduced a new Bitbucket REST API endpoint that allows a Forge app to retrieve the clientKey of its linked Connect app installation.

This endpoint supports the migration process from Connect to Forge. By retrieving the clientKey, the installed Forge app can identify the equivalent Connect app installation, enabling you to perform data migration or cleanup tasks effectively.

What you need to do
To use this endpoint, ensure you have configured the linkage between your Connect and Forge apps.

  • Add the forgeAppId key to your Connect app descriptor.

  • Use the new endpoint to fetch the clientKey during your app's migration logic.

More details

See https://developer.atlassian.com/cloud/bitbucket/link-connect-to-its-equivalent-forge-app/ on how to configure your Connect → Forge app linkage.

1 May 2026

Deprecation Notice Deprecation and Removal of Legacy Bitbucket Cloud Code Search API

We are deprecating the Bitbucket Cloud legacy code search API endpoints effective May 1, 2026, with full removal on November 1, 2026.

The following endpoints are being decommissioned and will be removed on November 1, 2026:

  • GET /2.0/repositories/{workspace}/{repo_slug}/search/codeRepository-level code search

  • GET /2.0/workspaces/{workspace}/search/codeWorkspace-level code search

We are actively working on the new API which will be released ahead of the removal.

8 April 2026

Deprecation Notice Brownout Notice: OAuth 2.0 and API authentication changes for Bitbucket Cloud

As shared in our https://developer.atlassian.com/cloud/bitbucket/changelog/#CHANGE-3052, Bitbucket Cloud will fully deprecate / change behaviour for a small set of OAuth2 features on May 4, 2026. To help teams identify and migrate any remaining usage ahead of the enforcement date, we will run a series of controlled brownouts starting Apr 20, 2026, for two weeks, after which the functionality will be fully removed on May 4, 2026.

During each brownout window:

  • All OAuth authenticated requests directed at www.bitbucket.org will fail with an HTTP 401 error code

  • All OAuth authenticated requests which provide the OAuth access token in the access_token query parameters / POST body will fail with an HTTP 401 error code

  • The Client credentials grant flow will not issue refresh tokens in their token response.

  • OAuth token response payloads will return “scope"  instead of “scopes" (See notes)

Notes:

  • The minting of OAuth2 access tokens should always be made to https://bitbucket.org/site/oauth2/access_token. Bitbucket’s API does not mount these urls under the api subdomain.

  • In the week beginning Apr 12, 2026 the scope property will be returned alongside the scopes property, allowing time to onboard prior to the start of the brownout.

More details

Dates

Brownout duration per window

Brownout window start times (UTC)

Apr 20, 2026

15 minutes

00:00, 06:00, 12:00, 18:00

Apr 21, 2026

15 minutes

00:00, 06:00, 12:00, 18:00

Apr 22, 2026

30 minutes

00:00, 06:00, 12:00, 18:00

Apr 23, 2026

30 minutes

00:00, 06:00, 12:00, 18:00

Apr 24, 2026

1 hour

00:00, 06:00, 12:00, 18:00

Apr 25, 2026

1 hour

00:00, 06:00, 12:00, 18:00

Apr 26, 2026

2 hours

00:00, 06:00, 12:00, 18:00

Apr 27, 2026

2 hours

00:00, 06:00, 12:00, 18:00

Apr 28, 2026

3 hours

00:00, 06:00, 12:00, 18:00

Apr 29, 2026

3 hours

00:00, 06:00, 12:00, 18:00

Apr 30, 2026

4 hours

00:00, 06:00, 12:00, 18:00

May 1, 2026

4 hours

00:00, 06:00, 12:00, 18:00

May 2, 2026

5 hours

00:00, 06:00, 12:00, 18:00

May 3, 2026

5 hours

00:00, 06:00, 12:00, 18:00

May 4, 2026

Final removal

 

5 March 2026

Announcement Nominations for critical Connect -> Forge migration blockers now open

You can now nominate genuine migration blockers or major customer‑impact risks via the “Request review” flow on FRGE issues.

This flow will allow us to triage and assess requests to address remaining blockers to Forge migration before Connect end of support in December 2026. We’ll review requests over 3 monthly cycles, then freeze decisions.

Please review for existing tickets before creating new FRGE tickets. You may also review the announcement.

2 March 2026

Added Bitbucket deployment events are now available as Forge triggers

We've introduced three new Forge triggers for Bitbucket deployment events. These triggers allow your Forge app to respond to deployment lifecycle events in Bitbucket Pipelines.

The new triggers are:

  • avi:bitbucket:pending:deployment — Fires when a deployment is pending

  • avi:bitbucket:started:deployment — Fires when a deployment starts

  • avi:bitbucket:completed:deployment — Fires when a deployment completes

To use these triggers, add them to the trigger section of your app's manifest.yml file. Each trigger provides deployment event data including environment, state, and pipeline details.

For more information, see Bitbucket events.

1 March 2026

Removed Removal of Connect Inspector Service

Following this deprecation announcement on Feb 17, 2026, the Connect Inspector Service is now decommissoned.

We recommend migrating to Atlassian Forge for a more robust Events model, as Atlassian Connect will reach end of support in December 2026.

Developers who still need similar functionality can use the open‑sourced version of the tool.

Rate this page: