Do you having an API to push the content to BitBucket Repo.

I have gone through your Bitbucket API Documentation, i could not found any API to push the content (i.e) data to the Bitbucket Repository either a raw data or an data in encoded(base64) format. Is there is any API to push the content?

7 answers

1 accepted

Correct. We now have an API for exactly this. You can upload new content to create new commits and branches through that rest API.

Hi @Erik van Zijst

How can you delete a file through the api?  That endpoint doesn't accept delete command and I can't find anywhere that does in the documentation..

You delete a file by creating a new commit that doesn't have the file in question. This is modeled after git/hg where you delete a file by creating a new commit that whose tree doesn't contain the path.

It's documented in the "files" parameter:

Bitbucket API_2017-08-14_13-29-32.png

"when the files field contains a file path that does not have a corresponding, identically-named form field, then Bitbucket interprets that as the client wanting to replace the named file with the null set and the file is deleted instead."

Ah thanks should have read a bit further down.  It indeed does work like this.

This widget could not be displayed.

What exactly do you mean by "content (i.e) data"?  The REST API allows you to do commits (and other stuff like pull requests), so I'm not quite sure what you're missing here?

Technically, the (Cloud) API does not allow one to create new commits.

Thanks Nic and Erik.. Actually I searched API to push the content directly to repo.. For ex in github they providing an API to push the content into repo along with commit msg.

Hello Eric,

I am trying to update the specific file in repository hosted on bitbucket.

In order to use above api do we need authentication? How to do that?

My host url looks like below :

This widget could not be displayed.

No. Pushing new content to a repo is done through pushing, not the API. There is the online editor, but that does not currently have a public API.


Can you provide an example of what the file parameter is supposed to look like? Do i specify the file name followed by the content? 


This widget could not be displayed.

Do you mean "a way to push a file with data into the repo" ? This hence is not Bitbucket but git specific, and you should do it like that:

1/(git) Clone your repo
git clone <repo_url>

2/ Navigate where you want, and add the file in the project path

3/(git) Add the file and push it to the main repo.

git add <file_with_data>
git commit -a -m "<message>"
git push

This widget could not be displayed.

Hi there!

This is not really an answer, I just want to add that I understand the question.


We at LingoHub we provide our customers a possibility to create a file and push it to the branch of their repository.

We do not have the repository of our customers on our application server (I think you understand that this would be a bad idea). So we are not able to use git CLI commands to push files to the repo.

The Github API allows us to do so by using the BLOB endpoint:


For our customers who are using Bitbucket we are not able to offer this key feature of our application because we haven't found an equivalent endpoint in the Bitbucket API. 



This widget could not be displayed.

Hi !

I am working on service which will allow you to store cluster configurations in git repositories. So main functional here is to push cluster configuration to the repo without cloning it. I use github and bitbucket as services where user can store configurations. 

But when I've done with github(there is an API for adding a new commit to the repo and pushing files), I stuck with bitbucket, I didn't find any API endpoint that would allow me to push file contents to the repository. Is it still unavailable? Or I can find it somewhere?

Note: I went through downloads API but it is not what I need. 

This widget could not be displayed.

Hey guys!


Has there been any movement on this? Even I have a requirement to push new files to Bitbucket via the API. 

Any movement on this?  I too am running up against this issue!  I should have thoroughly checked the API before getting as far as I have.  I really hope there is some way to push updates via the API.  Some kind of response would be great.

anyone got an answer ? I really need this functionality 

I am also trying to push files to bitbucket via API, I am using postman to test it out and I am getting an html page in response instead of json object. Please let me know if there is a way to push update to bitbucket. Thank you

Yes, as per:

If you're getting an error, then we'd probably need to see what it said before we could tell you what the problem was. Maybe paste a public link to the postman request here? Otherwise maybe send it to us through ?

Suggest an answer

Log in or Sign up to answer
Atlassian Summit 2018

Meet the community IRL

Atlassian Summit is an excellent opportunity for in-person support, training, and networking.

Learn more
Community showcase
Posted Friday in Bitbucket

What is your #1 piece of advice to new users getting started using Bitbucket?

Hello Community! My name is Claire Maynard, and I’m a Product Marketing Manager on the Bitbucket team. I’m interested in hearing what advice or tips you have for new users getting started on ...

169 views 9 2
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