Jira Data Ingestion

Turn your Jira history into AI knowledge. Import resolved issues, bug reports, and feature discussions so your Guru can answer questions based on real engineering context and decisions.

Why Ingest Jira Data?

Engineering Context

Past issues contain decisions, workarounds, and solutions that help answer new questions

JQL-Powered Selection

Use Jira Query Language to import exactly the issues you need

Attachments Included

Images, logs, and text files attached to issues are indexed too

Auto-Sync

Backfill jobs automatically import new resolved issues on a schedule

What Gets Indexed

Content Type	What’s Included
Issues	Issue title, description, and all fields
Comments	Full comment threads with context
Attachments	Images, logs, and text files
Metadata	Status, priority, labels, and resolution

Self-Hosted (Enterprise): This integration is in beta for selected users. Cloud: Available to all users.

Setup

Create Atlassian API Token

Go to Atlassian API Token settings
Click Create API token
Copy the token

Navigate to Jira Integration

Go to Gurubase Dashboard → Select your Guru → Integrations → Ingestions → Jira

Connect Your Jira

Fill in the connection details:

Field	Value
Domain	Your Atlassian domain (e.g., `yourcompany.atlassian.net`)
User Email	Your Atlassian account email
API Token	The token you created in Step 1

Adding Jira Content

After connecting, you can import issues in two ways:

Option 1: Add Individual Issues

Best for importing specific issues by URL.

Setting	Description
URLs	Enter issue URLs, one per line
Date Range	Optionally filter by creation date
JQL Filter	Additional JQL criteria (e.g., `status = "Done"`)

Option 2: Create Backfill Job

Best for bulk imports and automatic ongoing sync using JQL queries.

Setting	Description
JQL Query	Query to select which issues to import
Sync Interval	How often to check for new issues (minimum 1 hour)
Sync Now	Manually trigger an immediate sync

Example JQL Queries

-- All resolved issues from a project
project = "SUPPORT" AND status = "Done"

-- Recent high-priority bugs
project = "ENG" AND type = "Bug" AND priority = "High" AND created >= -30d

-- Issues with specific labels
labels IN ("documentation", "faq") AND resolution IS NOT EMPTY

Import resolved issues to build knowledge from solutions. Use backfill jobs to automatically keep your Guru updated as new issues are resolved.

Viewing Indexed Content

Imported issues appear as individual sources in your Guru’s data sources list. You can:

View the exact content that was indexed
Remove specific issues
Check when content was last synced

Next Steps

Jira Bot

Deploy Gurubase as a Jira bot for ticket responses

Confluence Ingestion

Import Confluence pages

Zendesk Ingestion

Import Zendesk tickets and articles

Data Sources

Add more knowledge sources

Get Started

Guides

Integrations

Advanced