Skip to main content

Jira Connector

Hana's Jira connector lets you bring your Jira projects and issues directly into every chat.

Prerequisites​

  • Active Jira Cloud account
  • Admin-level permissions in Hana Dashboard (ADMIN or DOMAIN_OWNER)
  • An Atlassian API token (see below)

1 · Connect Jira to Hana​

  1. Open the Connectors tab (https://hana-dashboard.hanabitech.com/connectors).
  2. Click Connect on the Jira card.
  3. Select Connect Jira.
  4. Enter your Site URL, API token and Atlassian-account e-mail then Submit.
URL format

Use your Atlassian cloud URL (for example, https://your-company.atlassian.net).
Hana normalizes Jira base URLs internally, but starting with the root cloud URL avoids mistakes.

Important when creating the API token
  • Scoped Atlassian API tokens are supported. Use the minimum required scopes for your Hana-Jira workflow.
  • If your workflow later needs additional permissions, manage them from Dashboard → Settings → OAuth Scopes, then re-run consent.
  • Set the token’s expiry to the maximum allowed date so you don’t have to regenerate it often.
Need help generating a token?

Follow Atlassian’s step-by-step guide: https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/

2 · Ingest Jira projects as memories​

  1. Go to Memories ➜ Jira Memory (https://hana-dashboard.hanabitech.com/memory?tab=jiraMemoryList).
  2. Click Add Jira Memory.
  3. Choose the connected Jira account.
  4. Enter one or more project keys, comma-separated (e.g. API, JIRA).
  5. Click Submit. Status will move from IN_PROGRESS ➜ INGESTED once indexing finishes. Hana can now answer questions using the issues from those projects.
Key uniqueness behavior

For the same connected Jira account, re-adding an already-ingested project key is treated as a duplicate and is rejected.
Use Sync on the existing memory batch instead.

3 · Re-sync when issues change​

When issues in the project are updated:

  1. Return to Jira Memory.
  2. Click SYNC for the relevant project.
  3. The status returns to INGESTED once the latest content is indexed.

If ingestion fails, use Retry Ingestion from the row actions after fixing connector/key access issues.

FAQs​

What happens to memories if I disconnect Jira?​

The memories stay intact, but you won’t be able to re-sync them until a Jira account is connected again.

I see ERROR in the status column—what does it mean?​

The two most common causes are:

  • The stored API token has expired or was revoked.
  • One or more of the entered project keys are invalid or no longer accessible.

If neither of the above solves the issue, drop us a line at hana-bot@hanabitech.com.

Need help?​

• Support/Feedback form – Submit issue

Last updated on by nav