Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
4,299,742
Community Members
 
Community Events
165
Community Groups

What API version does my corp BB server is on?

How can I figure out on what API version my corp Bitbucket server has? we are on Atlassian Bitbucket v7.8.1 now.

http://<host>/bitbucket/rest/api/1.0/projects/<id>/repos

or

http://<host>/bitbucket/rest/api/latest/projects/<id>/repos

gives a list of expected JSON response but when I do

http://<host>/bitbucket/rest/api/2.0/projects/<id>/repos

it throws 'requested source is not available.' So does this mean the API is not beyond v1.0? or am I not pointing to the correct end point?

1 answer

Hi @Pratik , For most of the cases, the 1.0 version is what you want to use. You can check the documentation for all the available API resources here:

https://developer.atlassian.com/server/bitbucket/reference/rest-api/

Once you are on the page with the API references, e.g. https://docs.atlassian.com/bitbucket-server/rest/7.17.0/bitbucket-rest.html
you can change the version in browser URL to match your version, e.g. 7.8.1

I did a quick search on this page, and I think neither of the APIs there are using version 2.0.

Thanks,
Maciej Adamczak
Atlassian Developer

Thanks @Maciej Adamczak

I was looking on how to attach a file to bitbucket PR comment from Jenkins pipeline using curl, I have the PR comment part working already. Further looking into it I read bb API should be beyond v2.0.

Question, is bitbucket API v2.0 only available on cloud?

Bitbucket Cloud and Bitbucket Server/DC are two different products and have different APIs.

I don't know how the Cloud APIs are working but I think for the server/DC you can take a look at the `attachemnts` endpoint.

https://docs.atlassian.com/bitbucket-server/rest/7.17.0/bitbucket-rest.html#idp204

You should be able to send the binary file with the POST request. I'm not sure why, but it's missing in the docs. You can try using the regular Bitbucket commenting UI and browser devtools to try to recreate the request.

Like Pratik likes this

Example of the request:

Add file as attachment

 

curl -k -u admin:admin \
     -X POST 'http://localhost:7990/projects/{projectKey}/repos/{repositorySlug}/attachments' \
     -H 'Content-Type: multipart/form-data' \
     -F 'files=@foo.txt'

As a response, you should expect:

SAMPLE RESPONSE
{"attachments":
 [
  {
    "id":"3",
    "url":"http://localhost:7990/bitbucket/projects/TEST/repos/attachments/attachments/3",
    "links":{
        "self":{"href":"http://localhost:7990/bitbucket/projects/TEST/repos/attachments/attachments/3"},
        "attachment":{"href":"attachment:1/3"}
    	 }
   }
 ]
}

Add comment to pull-request, referring attachment in comment's message

curl -k -u admin:admin \
     -H 'Content-type: application/json' \
     -X POST 'http://localhost:7990/rest/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/comments' \
     -d '{"text": "From Local Drive - [foo.txt](attachment:1/3)"}'

 

Like Pratik likes this

Suggest an answer

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

Git push size limits are coming to Bitbucket Cloud starting April 4th, 2022

Beginning on April 4th, we will be implementing push limits. This means that your push cannot be completed if it is over 3.5 GB. If you do attempt to complete a push that is over 3.5 GB, it will fail...

2,247 views 2 9
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