How to Manage/Automate Bitbucket Repos "As Code" (IaC)

[traiano]

I have a requirement to automate creation of Bitbucket repos using code and manage permissions and repo settings.

I have tested a terraform provider for bitbucket but it is frankly defective.: https://registry.terraform.io/providers/zahiar/bitbucket/latest/docs/resources/bitbucket_repository

Is there another tested approach for automating the management of BB repos along the same lines as the above terraform concept?

Thanks in advance!

[Theodora Boudale]

Hi @traiano,

We offer API endpoints that you could use for this purpose.

This is the documentation of our API:

• https://developer.atlassian.com/cloud/bitbucket/rest/intro/

You can navigate from the left sidebar on the different endpoints.

We also provide temporary support for certain 1.0 endpoints, until we have an implementation in v. 2.0 of our API:

• https://support.atlassian.com/bitbucket-cloud/docs/use-bitbucket-rest-api-version-1/

Please feel free to reach out if you have any questions!

Kind regards,
Theodora

[traiano]

Thanks @Theodora Boudale  - regarding the users and groups endpoints: I see user and group management is available via the 1.0 API, however, how long will this functionality be available?

[Theodora Boudale]

Hi @traiano,

It will be available until we have equivalent endpoints in v 2.0. I will reach out internally to find out if we have a rough estimate on when that will be, I will let you know as soon as I have an update.

Kind regards,
Theodora

[Theodora Boudale]

Hi @traiano,

We haven't set the deprecation date for these endpoints so I don't have a date to share. However, we will give a few months notice when we do and we will communicate updates via a community article and also on this page:

• https://developer.atlassian.com/cloud/bitbucket/

Just a heads up, if you get an Atlassian Access subscription and you link your Bitbucket workspace in http://admin.atlassian.com/ from Products > ... > Link products, these endpoints will stop working (if you don't do this, you can continue to use these endpoints until we deprecate them).

This is mentioned in the second to last (at the moment) announcement of the page I shared:

• https://developer.atlassian.com/cloud/bitbucket/announcement-breaking-change-remaining-10-endpoints/

Kind regards,
Theodora