Skip to main content

Documentation Index

Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt

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

Back to Search AI connectors list Jira is a project management and issue-tracking platform that enables teams to plan, track, and coordinate tasks through customizable workflows. The Jira On-Premise connector lets Search AI ingest, index, and search through Work Items from a self-hosted Jira server, improving accessibility to content from on-premise Jira deployments.

Connector Specifications

SpecificationDetails
Repository typeOn-Prem
Supported contentWork Items
RACL supportYes
Content filteringYes
Automatic permission resolutionYes

Prerequisites

An Atlassian account with admin access. This account fetches content and resolves access permissions for indexed content. Search AI uses basic authentication to communicate with the Jira server.

Configure the Jira Cloud Connector in Search AI

  1. Go to the Connectors page and select Jira Server Connector.
  2. Create or select a Profile.
    Each profile saves its own credentials, filters, and mappings. You can maintain multiple profiles under a single connector.
  3. In the profile setup, provide the following fields:
    FieldDescription
    NameUnique name for the connector profile
    EmailAtlassian account email address used for indexing
    DomainJira Cloud domain (For example <your-domain>.atlassian.net)
    API TokenAPI token generated from your Atlassian account
  4. Click Connect to authenticate the profile.
  5. Repeat the process to add additional profiles as needed.

Multiple Authentication Profiles

A single Jira Server Connector supports multiple authentication profiles.
  • Each profile uses its own credentials and domain.
  • Content sync runs across all configured profiles.
  • This simplifies multi-account management, reduces the need for multiple connectors, and scales better for enterprise use cases.

Content Ingestion

The connector ingests Work Items from Jira. Each work item is indexed with the following fields:
FieldDescription
titleSummary or title of the work item
contentFull description of the work item
urlDirect link to the work item in Jira
doc_created_by_nameName of the user who created the work item
doc_created_onTimestamp when the work item was created (UTC)
doc_updated_onTimestamp of the latest update (UTC)
doc_source_typeType of content ingested
priorityWork item priority (High, Medium, Low, etc.)
statusWork item status (open, closed, etc.)
assigneeUsername of the currently assigned person
reporter_nameName of the user who reported the work item
commentsAll comments concatenated, including commenter names
issueTypeType of work item (Bug, Task, Story)
resource_typeType of work item
project_nameName of the Jira project
All timestamps are stored in UTC. Work item comments are concatenated into a single field; individual comment metadata is not indexed.

Content Filtering

The Jira Server connector supports standard and advanced filters to control which content is ingested. On the Manage Content page, select Ingest All Content to ingest everything, or select Ingest Filtered Content and click Configure for selective ingestion. Standard Filters

Standard Filters

Use standard filters to ingest work items from specific projects. Select one or more projects — all work items within those projects are ingested. You can also define a date range using the calendar selector to limit ingestion to a specific time frame.

Advanced Filters

Advanced filters provide granular control through field-based rules. Since only Work Items are supported for the Jira server connector, rules apply to work items only. For example, ingest only specific types of work items from a particular project. Advanced Filters Select Work Items fields from the parameter list, then provide operators and values to set filter conditions. Add custom fields as needed — field names must match the field names in your Jira server instance.

Filter Precedence

Advanced filters override standard filters when their criteria conflict. For example, if a standard filter selects Project A and an advanced filter specifies Project B by key, Project B takes precedence.

Access Control

Work Items

  • Each work item is linked to a project via a unique Project ID.
  • This Project ID is stored in the RACL field of the ingested chunks.
  • Associate users with a Project ID using the Permission Entity APIs. Users added to the corresponding permission entities gain access to work items associated with those projects.