Metalogue
Docs

Jira Integration

Connect Jira projects, issues, and sprints to Metalogue

Jira Integration

Connect your Jira instance to index projects, issues, comments, and sprint data.

Quick Start

const connector = await client.createConnector({
  connector_type: 'jira',
  display_name: 'Company Jira',
  credentials: {
    domain: 'company.atlassian.net',
    email: 'admin@company.com',
    api_token: 'ATATT3xFfGF0...',
  },
});

await client.syncConnector(connector.connector_id, true);

Authentication

API Token (Cloud)

{
  "credentials": {
    "domain": "company.atlassian.net",
    "email": "admin@company.com",
    "api_token": "ATATT3xFfGF0..."
  }
}

OAuth 2.0

GET /v1/connectors/jira/oauth-url

Synced Content

Content TypeDescriptionIndexed Fields
IssuesTickets, bugs, storiessummary, description, comments
ProjectsProject metadataname, description, lead
SprintsAgile sprintsname, goals, issues
EpicsLarge featuressummary, description
AttachmentsFiles on issuesname, content (text)

Configuration

{
  "settings": {
    "projects": ["PROJ1", "PROJ2"],
    "issue_types": ["Bug", "Story", "Task"],
    "include_resolved": true,
    "include_attachments": true,
    "max_attachment_size_mb": 10
  }
}

JQL Filtering

Filter which issues to sync using JQL:

{
  "settings": {
    "jql_filter": "project = PROJ AND status != Done AND created >= -30d"
  }
}

Example Queries

// Find issues about authentication bugs
const results = await client.query({
  text: 'authentication login error',
  filters: {
    connector_type: 'jira',
    document_type: 'issue'
  }
});

Webhooks

Real-time sync via Jira webhooks:

  • jira:issue_created
  • jira:issue_updated
  • comment_created
  • sprint_started

Rate Limits

  • Cloud: 100 requests/minute
  • Data Center: Configurable

Next Steps