Bitbucket Cloud

Use Bitbucket Cloud as a source for your API definitions and developer portal projects.

Connect the source

  1. When adding a new API definition or developer portal to Workflows, select Bitbucket as the source provider in the Choose source step. Select Next to proceed to the next step.

Connect Bitbucket Cloud

  1. If Bitbucket Cloud has not been previously configured for your Workflows user account, you will be redirected to Bitbucket. In this step, you must authorize the Redocly Workflows app so that it can access your Bitbucket repositories.

Authorize Workflows to access your Bitbucket account

  1. In the Source settings step, configure the source details for your API definition or developer portal project.
  2. First, select a workspace under Bitbucket workspaces. When you select the workspace, the list of repositories will be populated with those available to you.
  3. Under Repositories, select a repository for the project that you want to add to Workflows. When you select the repository, the list of branches available will be populated.
  4. Lastly, under Source settings, select the branch to use for your production deployment. For API definition projects, you must also provide the path to your root file in this step.

Configure Bitbucket Cloud source

  1. For API definitions, you can select the optional Validate and bundle from PRs checkbox.

For developer portals, you can select the optional Build PR as previews checkbox.

These options instruct Workflows to trigger a build when:

  • a new pull request is opened to your production branch
  • a new commit is pushed to any open pull request

If your API version is used in other projects, it will also trigger subsequent cascading preview builds of other APIs, reference docs, and developer portals.

Leaving these options unselected does not interfere with builds from your production branch.

Complete the source configuration

After setting up the Bitbucket source, select Next to provide a name for your API version or developer portal. Select Finish to complete the configuration.

When you have successfully connected Bitbucket Cloud as a Workflows source and completed your first build, you'll be able to see the build status directly in your Bitbucket repository, and access build previews on Workflows from there.