Can App Password be used to create a branch

Sam Bennett_0ptbyc

When creating the App Password, I am able to select the permission repository:write. However, whenever I attempt to use:

POST /2.0/repositories/{workspace}/{repo_slug}/refs/branches

all it does is returns the list of branches. I can see that it states:

OAuth 2.0 scopes required:

repository:write

But does that mean that this can only be used through an OAuth request?

Ben

Hey Sam,

App Password can indeed be used to execute API requests such as this one.

You can run the following request to create a branch using the /2.0/repositories API endpoint:

curl https://api.bitbucket.org/2.0/repositories/{workspace}/{repository}/refs/branches 
-s -u username:AppPassword -X POST -H "Content-Type: application/json" 
-d '{
"name" : "{new_branch_name}",
"target" : {
"hash" : "main"
}
}'

"Main" should be the existing branch or commit hash from where you want to create a new branch.

The API documentation can be found here:

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-refs/#api-repositories-workspace-repo-slug-refs-branches-post

Cheers!

- Ben (Bitbucket Cloud Support)