Include pull requests list ☁️

You can include information on pull requests from a Bitbucket repository by adding lists of pull requests in your Confluence page. For each pull request you will get the name, branch, author, id and last updated information.

Add the macro

You can add the macro either by:

typing directly /Bitbucket Pull Requests and ENTER, or
using the Insert button from the editor toolbar and then picking the Bitbucket Pull Requests macro from the “External Content” category of the macro library.

You will then be prompted to specify the following:

`Workspace name`	Name of the workspace including the repository
`Repository name`	name of the repository
`Search query` (optional)	Query used to filter and sort the list of issues. Check out the section below for more information on querying.

Adding a list of pull requests from Bitbucket screen — Adding a list of Pull Requests

Query specific sets of pull requests

As mentioned above you can add a query option to the macro to display a specifically filtered list of pull requests.

The filtering syntax supported by the Bitbucket API is available in their documentation here: The Bitbucket Cloud REST API

Examples:

List all open pull requests whose author’s username is diego	`state = "OPEN" AND author.username ~ "diego"`
List all merged pull requests for which the destination branch is master and the reviewer’s username is diego	`state="MERGED" AND reviewers.username="diego" AND destination.branch.name = "master"`

When adding search queries you can run the query and preview results simply by clicking out of the search query input field.