Create a Workspace Access Token

Workspace Access Tokens are a premium feature. To learn about the Bitbucket Cloud Premium plan, visit: Bitbucket Cloud Premium.

Workspace Access Tokens are single-purpose access tokens (or passwords) with access to a single workspace with limited permissions (specified at creation time). Use tokens for tasks such as scripting, CI/CD tools, and testing Bitbucket integrations or Marketplace apps while in development.

To create a Workspace Access Token:

  1. At bitbucket.org, navigate to the target workspace for the Access Token. This workspace is the only one that the Workspace Access Token can access.

  2. On the sidebar, select Settings.

  3. On the sidebar, under Security, select Access tokens.

  4. Select Create Workspace Access Token.

  5. Give the Workspace Access Token a name, usually related to the app or task that will use the token.

  6. Select the permissions the Workspace Access Token needs. For detailed descriptions of each permission, see Workspace Access Token permissions.

  7. Select the Create button. The page will display the Workspace Access Token created dialog.

  8. Copy the generated token and either record or paste it into the app that requires access. The token is only displayed once and can't be retrieved later. Rather than recovering or reusing a Workspace Access Token, create a new token and consider revoking the old token.

Additional Help