Create Jira Feed

User Intent

"How do I sync Jira issues? Show me Jira feed configuration."

Operation

SDK Method: createFeed() with FeedTypes.Issue Feed Service: Jira Auth: API token


Code Example (TypeScript)

import { Graphlit } from 'graphlit-client';
import {
  FeedTypes,
  FeedServiceTypes,
  AtlassianJiraFeedPropertiesInput,
} from 'graphlit-client/dist/generated/graphql-types';

const graphlit = new Graphlit();

const jiraSiteUrl = process.env.JIRA_SITE_URL!; // e.g., https://company.atlassian.net
const jiraProjectKey = process.env.JIRA_PROJECT_KEY!; // e.g., ENG

const feed = await graphlit.createFeed({
  name: 'Engineering Jira',
  type: FeedTypes.Issue,
  issue: {
    type: FeedServiceTypes.AtlassianJira,
    jira: {
      uri: jiraSiteUrl,
      email: process.env.JIRA_EMAIL!,
      token: process.env.JIRA_API_TOKEN!,
      project: jiraProjectKey,
      readLimit: 100,
      includeAttachments: true,
    },
  },
  // Optional: add workflow for content processing
  // workflow: { id: workflow.createWorkflow.id }
});

Configuration

uri: Jira instance URL project: Project key email/token: Atlassian account email and API token readLimit: Number of issues per sync includeAttachments: Toggle attachment ingestion


API Token Setup

  1. Jira → Account settings → Security → API tokens

  2. Create new API token and copy it to JIRA_API_TOKEN

  3. Set JIRA_EMAIL to the Atlassian account email

  4. Set JIRA_SITE_URL (for example, https://company.atlassian.net)

  5. Set JIRA_PROJECT_KEY to the project you want to sync

ℹ️ Finding project keys: Jira project keys are visible in the project list (Projects → View all projects) or via the Jira REST API (GET /rest/api/3/project/search). Use the exact key (e.g., ENG).


Last updated

Was this helpful?