how to check branches permissions in bitbucket server using rest api ?

[IC Admin]

Hello,

On our Bitbucket Server we want to add a control regarding the permissions on the branches.
As we open the create project and create repository rights to our users, we want to be sure to have at least a security on the branches management.

Is there anys way to check the branches permissions model using the rest API in order to automatise such a check ?

For instance, to be sure that any deletion of the master branch could be made only by a speficif group of users.

Thanks.

[Felix · Accepted solution]

There is a REST API for branch permissions, which is documented here.

If you're using just a "plain" branch permission (ie. not using the branching model or patterns), a GET to the following path will return the "no deletes" branch permission for the master branch:

/rest/branch-permissions/2.0/projects/<PROJECT_KEY>/repos/<REPO_SLUG>/restrictions?type=no-deletes&matcherType=BRANCH&matcherId=refs/heads/master

[IC Admin]

Thank you for your answer, this is what we were looking for.