You're on your way to the next level! Join the Kudos program to earn points and save your progress.
Level 1: Seed
25 / 150 points
Next: Root
1 badge earned
Challenges come and go, but your rewards stay with you. Do more to earn more!
What goes around comes around! Share the love by gifting kudos to your peers.
Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!
Join now to unlock these features and more
The Atlassian Community can help you and your team get more value out of Atlassian products and practices.
I am trying to develope apapter for BitBucket Cloud using BitBucket REST API 2.0.
My requirement is to create a new branch using API. But I am not able to find any API for that. However there is one API to GET branches but API to PUT a branch is not there. Pls help.
Thanks for reply. Actually I was using Bibucket local server instance not the cloud one... but I guess the API would be same except the base url..
Has the API changed?
I'm getting {"type": "error", "error": {"message": "Something went wrong", "id": "b074e82335e948b897f5525a16c883ac"}} 500 when I post to this endpoint.
Thanks,
Tony
Hi Tony. Do you mind if I ask what arguments you were passing to the API? You don't have to give me the specific values for repository or for the arguments I'm just wondering which arguments you are passing to the API.
I tried many variations of the following:
curl -X POST "https://api.bitbucket.org/2.0/repositories/owner/my-repo-test/src/?access_token=${access_token}" -F "branch=tony"
curl -X POST "https://api.bitbucket.org/2.0/repositories/owner/my-repo-test/src/?access_token=${access_token}" -d "branch=tony"
TIA,
Tony
In case anyone else needs this, use the follow for creating a new branch via the API: https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Busername%7D/%7Brepo_slug%7D/refs/branches#post
@Tony Carter This issue has been identified and fixed. We appreciate the time you took to report it. The error response is very useful!
@sergio ramos Unfortunately the APIs aren't the same. Please check out the server documentation here: https://developer.atlassian.com/server/bitbucket/reference/rest-api/
Thanks!
This works for me.. is there a way to modify the empty commit message in the request? It currently reads "Edited with Bitbucket".
Also, you mentioned "unless you also commit files when you create the branch" .. how would you do this via api when creating the branch?
@blossm-steve-personal - Yes, you can specify a commit message and upload files at the same time.
See the API documentation for examples.
Let me know if the docs are clear enough.
Eric Henry
Development Team Lead, Bitbucket Cloud
For BB cloud, there are two ways:
1) This one will create a commit though, so your branch will be 1 commit ahead of your master...
curl -X POST -is -u user:pass https://api.bitbucket.org/2.0/repositories/{workspace}/{repo_slug}/src --form "parents=name_of_branch_to_create_from" --form "branch=name_of_branch_to_create"
2) This one will just create the branch:
curl -X POST -is -u user:pass -H 'Content-Type: application/json' https://api.bitbucket.org/2.0/repositories/{workspace}/{repo_slug}/refs/branches -d '{ "name": "name_of_branch_to_create", "target": { "hash": "name_of_branch_to_create_from" } }'
Have fun...
Thank you.
Note - the call shown in 1) is in API docs here: https://developer.atlassian.com/cloud/bitbucket/rest/api-group-source/#api-repositories-workspace-repo-slug-src-post
For anyone coming here for branch deletion, https://stackoverflow.com/questions/50006997/how-to-delete-a-branch-using-bitbucket-rest-api/74281876#74281876
curl --location --request DELETE 'https://api.bitbucket.org/2.0/repositories/{workspace}/{repo_slug}/refs/branches/{branchname}'