Keys / Atlassian

JIRA_API_TOKEN

The Atlassian account API token your script calls the Jira Cloud REST API with, sent with your account email over basic auth.

Expires
you choose, 1 to 365 days
API
list and delete a managed account's tokens, with an organization API key; no create

Get it

Create one on id.atlassian.com/manage-profile/security/api-tokens. The steps aren't recorded yet.

Set it

JIRA_API_TOKEN=...

Atlassian's Jira Login GitHub Action, atlassian/gajira-login, reads it with JIRA_BASE_URL and JIRA_USER_EMAIL. Other apps pass the token in. Or keep it out of .env with keypin: keypin run -- npm run dev

Replace it

  1. On the API tokens page of your Atlassian account, create a new token. Give it the same app and scopes as the old one, if it had scopes.
  2. Deploy it everywhere that reads JIRA_API_TOKEN. Both tokens work in the meantime.
  3. Check that nothing still uses the old token, then revoke it.

Set rotate_every on the key in keypin.toml and a rotated date on its vault item, and keypin status shows when it's due.

Sources, checked 2026-11-16