Using participant filters with Bitbucket REST API

How does one use the Participant Filters with the Bitbucket Pull Request REST API,

https://developer.atlassian.com/static/rest/bitbucket-server/5.1.0/bitbucket-rest.html#idm45588160117632

 

it sounds like I should be able to filter on a specific user, but I'm not sure how to construct the query.

Thank you.

1 answer

1 accepted

0 vote
Jeff Thomas Atlassian Team Jun 19, 2017

Hi Matt,

The participant filters can just be tacked on as query parameters. For example, if you wanted to find all the pull requests where the "admin" user was a reviewer and had not approved them yet, you could run:

curl -X GET \
  'https://bitbucket.company.com/rest/api/1.0/projects/PROJ/repos/REPO/pull-requests?username.1=admin&role.1=REVIEWER&approved.1=false' \
  -H 'content-type: application/json'

Or if you just wanted all pull requests where the "admin" user was a participant on a pull request you could run:

curl -X GET \
  'https://bitbucket.company.com/rest/api/1.0/projects/PROJ/repos/REPO/pull-requests?username.1=admin' \
  -H 'content-type: application/json'

Thank you! I couldn't make sense of the documentation but now with an example it makes perfect sense.

Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Posted Jun 12, 2018 in Bitbucket

Do you use any Atlassian products for your personal projects?

After spinning my wheels trying to get organized enough to write a book for National Novel Writing Month (NaNoWriMo) I took my affinity for Atlassian products from my work life and decided to tr...

135 views 17 6
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you