Skip to main content

Workspace API token

A Workspace API token allows Workspace members to access the Bitrise API without each member having to set up their own Personal Access Token. For API authentication, the Workspace token functions the exact same way as the Personal Access Token.

A Workspace owner can set up multiple Workspace API tokens, each with different access rights to the apps owned by the Workspace. The access rights are determined by user roles, just as it is for Workspace members or Workspace groups.

We recommend setting up any integrations that require an access token for API access using a Workspace API token instead of individual users' Personal Access Token.

Creating a Workspace API tokenClick to copy link​

  1. Log in to Bitrise and hover over the left navigation bar.

  2. Make sure you have the right workspace selected in the Workspace menu.

  3. Select Settings.

  4. On the left, select Security.

  5. Click Create token.

    workspace-api-token.svg

  6. On the Settings step, enter a Name and select an Expiration for the token.

  7. Select a Workspace role for the token. This determines what the token can do at the workspace level.

  8. Click Next.

  9. On the Product access step, set up what the token can access:

    • Toggle on Admin access to let the token manage all aspects of selected projects, with access to all products.
    • Toggle on Bitrise CI to let the token access CI builds. Choose Apply to: All projects or Selected projects, then select a Role — or leave it on No access.
    • Toggle on Release Management to let the token access Release Management, with permissions controlled by role at the app level.

  10. Click Create token.

  11. Click Copy and close to copy the token and close the dialog box.

    Save the token

    Once you closed the dialog box, you won't be able to see the token again!

Regenerating a Workspace API tokenClick to copy link​

If a Workspace API token is lost for any reason, there is no way to view it again. You have the option of regenerating the existing token: this way you don't have to create an entirely new token and configure app access again. The regenerated token will:

  • Have a new expiration date.
  • Have access to the exact same apps with the exact same roles as before.

  1. Log in to Bitrise and hover over the left navigation bar.

  2. Make sure you have the right workspace selected in the Workspace menu.

  3. Select Settings.

  4. On the left, select Security.

  5. Find your token and click the options menu (⋮) next to its name.

  6. Select Regenerate.

    regenerate-token.png

  7. Select the new expiration date.

  8. Click Regenerate to get the new token.

  9. Click Copy and close.

    Make sure to save the token in a secure way: you won't be able to see it again.