Summary

Provide public REST API endpoints and webhook events for Bitbucket Merge Queues to support programmatically managing and auditing the queue via external deployment orchestrators.

 

Customer Use Case and Problem

Teams using external orchestrators (e.g., for data pipelines like dbt) need to control precisely when a PR enters the merge queue to align with production deployment locks and long-running CD jobs. Currently, adding PRs to the queue relies on human UI interaction or automatic queuing. This prevents teams from enforcing strict automated policies, restricting manual human intervention, and maintaining a clear audit trail.

Requested Capabilities

• REST Endpoints:

• • POST / DELETE to programmatically add/remove a pull request to/from the merge queue.

• • GET to list pull requests currently in a queue.

• Exposed Data Fields: Queue position, per-PR queue status, the initiating actor (auto, manual, or API), and the target merge commit SHA.

• Webhook Events: Triggers for when a PR is queued, dequeued, changes position, or when queue validation starts, passes, or fails.