Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gurubase.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 TypeWhat’s Included
IssuesIssue title, description, and all fields
CommentsFull comment threads with context
AttachmentsImages, logs, and text files
MetadataStatus, priority, labels, and resolution
Self-Hosted (Enterprise): This integration is in beta for selected users. Cloud: Available to all users.

​
Setup

1

Create Atlassian API Token

  1. Go to Atlassian API Token settings
  2. Click Create API token
  3. Copy the token
2

Navigate to Jira Integration

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

Connect Your Jira

Fill in the connection details:
FieldValue
DomainYour Atlassian domain (e.g., yourcompany.atlassian.net)
User EmailYour Atlassian account email
API TokenThe token you created in Step 1
Jira Integration Fields

​
Adding Jira Content

After connecting, you can import issues in two ways:
Add Jira Content Modal

​
Option 1: Add Individual Issues

Best for importing specific issues by URL.
Add Individual Jira Issues
SettingDescription
URLsEnter issue URLs, one per line
Date RangeOptionally filter by creation date
JQL FilterAdditional JQL criteria (e.g., status = "Done")

​
Option 2: Create Backfill Job

Best for bulk imports and automatic ongoing sync using JQL queries.
Create Jira Backfill Job
SettingDescription
JQL QueryQuery to select which issues to import
Sync IntervalHow often to check for new issues (minimum 1 hour)
Sync NowManually 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