Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Next challenges

Recent achievements


  • Give kudos
  • My kudos


  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

How do you specify a reason when you are declining a Pull Request via the API?

When I use this rest call to decline a PR it works fine:


However, I don't see how to set the reason for declining the PR. I see this as an option in the UI, but don't see how to do it via the API when I looked in the docs. 



1 answer

1 accepted

0 votes
Answer accepted

Hello Kesniel,

If you’re wanting to decline a PR via the API and then add a comment for the reason of decline then you’ll need to make a second call to add the comment. The API endpoint for decline does not have a field to allow for commenting while declining. You’ll need to use POST | /2.0/repositories/{username}/{repo_slug}/pullrequests/{pull_request_id}/comments to add your comment.

If you’re having issues with the decline and comments endpoints please let us know so we may help.

Stephen Sifers

That worked. Thanks. 

Like Stephen Sifers likes this

For any one who stumbles upon this answer and can't actually post any comments on the PR using "ever-so-useful" documentation found at the link provided above,  let me help you out.

If you POST to the endpoint stipulated in the API documentation, with the JSON body: {"_body":"Your comment"} (as stipulated in the API documentation), you will get the following response from the API:

`````````"type": "error",    

    "error": {

        "fields": {            

        "content": "required key not provided",            

        "_body": "extra keys not allowed"        


    "message": "Bad request"    


Turns out, you actually need to supply the following JSON body, which is not mentioned anywhere in the API documentation!

{"content": {"raw": "Your comment"}}

I only found this out after trawling for other answers to "How do I post a reason for declining a PR using the Bitbucket API?" and found this thread The answer specifically came from josemonsalve2's comment on the 22nd of May 2019.

The Bitbucket API and its supporting documentation is shockingly poor in places. Please get them both up to spec, Atlassian! Two things that could be improved to dramatically improve the experience for others looking to automate PR declines through the Bitbucket API:

1. Allow API clients to supply a comment in the JSON body sent to the "/decline" endpoint

2. Actually specify the correct JSON body keys to send to endpoints in the API documentation!

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Bitbucket

Powering DevOps with Bitbucket Server & Data Center

Hi everyone, The Cloud team recently announced 12 new DevOps features that help developers ship better code, faster   ! While we’re all excited about the new improvements to Bitbucket ...

1,903 views 0 7
Read article

Community Events

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

Find an event

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

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you