Can App Password be used to create a branch

[Sam Bennett]

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)