Bulk update to permissions and repos

unknown

Hello all,

I am racing towards a deadline and urgently need to automate the following, Any help will be greatly appreciated.

1. Extract all permissions on all repos

1. Figure out a script or a way to bulk modify the permissions on specific repos

2. Figure out a script or a way to bulk add users to groups and modify repos to grant permission to users within these groups.

3. Figure out a script or a way to bulk delete users from a group.

 

I will be thankful if anyone can provide info on how to do this for BitBucket.

Thanks

Junaid

Theodora Boudale

Hi Junaid,

I see that you have created a support ticket for this issue and your questions have been answered there. I'll leave a reply here as well for any other users who may come across your post with the same questions.

Please allow me to give some context first, there are two ways for a user to gain/have access to a repo:

1. they can be granted direct access from Repository settings > User and group access > Add members
2. they can have access via a user group, i.e. be invited to a user group that has access to the repo

Regarding your questions:

Extract all permissions on all repos

You can use the following endpoint:

• https://developer.atlassian.com/cloud/bitbucket/rest/api-group-workspaces/#api-workspaces-workspace-permissions-repositories-get

Please note the following:

Permissions returned are effective permissions: the highest level of permission the user has. This does not distinguish between direct and indirect (group) privileges.

 

Figure out a script or a way to bulk modify the permissions on specific repos

If a user has direct access to a repo, it is not possible to modify their permissions via API, this needs to be done via the UI.

It is possible to modify the permissions of a certain user group via API using the following endpoint:

• https://support.atlassian.com/bitbucket-cloud/docs/groups-endpoint/#PUT-update-a-group

 

Figure out a script or a way to bulk add users to groups

You can invite a user to a user group with the following endpoint:

• https://support.atlassian.com/bitbucket-cloud/docs/invitations-resource/#Issue-an-invitation-to-a-group

 

modify repos to grant permission to users within these groups.

If the user group already has access to a certain repo, you don't need to take any action. However, if the user group doesn't have access to a repo, you can use the following endpoint to add the user group to a repo:

• https://support.atlassian.com/bitbucket-cloud/docs/group-privileges-endpoint/#PUT-group-privileges-on-a-repository

Figure out a script or a way to bulk delete users from a group.

You can use the following endpoint:

• https://support.atlassian.com/bitbucket-cloud/docs/groups-endpoint/#DELETE-a-member

Please note that if a user has direct repo access, in addition to access via a user group, it is not possible to revoke that direct access via API.

We have a feature request about this in our issue tracker: https://jira.atlassian.com/browse/BCLOUD-19896

Kind regards,
Theodora