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
- 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.
- Deploy it everywhere that reads
JIRA_API_TOKEN. Both tokens work in the meantime. - 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.