Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this page:

Table of Contents
minLevel1
maxLevel6
include
outlinefalse
indent
styledefault
exclude
typelist
class
printabletrue

API token for deployments between Jira Cloud sites

API tokens in Atlassian’s Atlassian's ecosystem allow you to authenticate against to Atlassian cloud apps like Jira Cloud, Confluence, Bitbucket, Fisheye, Crucible, etc. With the token, you:

  • bypass two-step verification and SSO, and,

  • retrieve data from the cloud sites through REST APIs.

Learn what are about API token controls from Atlassian's documentation.

Why do you need an API token with CMJ Cloud?

CMJ Cloud uses the API token to authorize you against to source and target Jira Cloud siteswhen deploying configuration. To create a configuration deployment in CMJ Cloud, you must provide your Atlassian account’s account's API token.

Tip

Benefits of using API tokens

With API tokens, CMJ Cloud doesn’t doesn't need your username and password to authorize you when communicating with Jira Cloud sites.

This approach allows CMJ Cloud to securely use the Jira Cloud services without requiring or storing user credentials.

How to create and manage API tokens from your Atlassian account?

You can create, view, and revoke an API token from your Atlassian account. Find more details about creating an API token in the How to get an API token section below.

You can also learn how to manage API tokens from Atlassian’s Atlassian's documentation.

Provide an API token in CMJ Cloud

  1. Log in as a user with the Jira site administrator Site or Organization admin permissions to your Jira Cloud site.

  2. Choose the cog icon at the top right corner of the screen, then choose Apps from the menu. 

  3. Navigate to the Configuration Manager section from the left-side menu.

  4. Navigate to Settings > Apps > Configuration Manager > Authorization.

  5. Provide an API token for your Atlassian account.

  6. Click Save token to store the token.

  7. You’ll You'll see a message indicating the API token has been stored.

Now, you’re You're all set to start deployments to Jira Cloud sites on the Configuration Deployment page.

Info

Can I provide an API token without having site Site or Organization admin permissions?

You can provide an API token without site Site or Org admin permissions, but you won’t won't be able to use CMJ Cloud's features.

CMJ Cloud requires site Site or Org admin permissions to deploy configurations between Jira Cloud sites.

How to get an API token

You can get an API token from your Atlassian account settings located at https://id.atlassian.com/manage.

Create an API token

  1. Log in to your Atlassian account https://id.atlassian.com/manage/api-tokens.

  2. Click Create API token.

  3. Choose a short and memorable label for your token from the dialog and click Create.

  4. Click Copy to clipboard, then paste the token and save it:

Additional Atlassian resources