DocsConnectors

Jira

Jira logo

Jira

Configuration

Jira source connector integrates with the Jira REST API to extract project management data.

Connects to your Jira Cloud instance.

It provides comprehensive access to projects, issues, and their relationships for agile development and issue tracking workflows.

View Source Code

Explore the Jira connector implementation

Authentication

This connector uses OAuth 2.0 authentication. You can connect through the Airweave UI or API using the OAuth flow.

Supported authentication methods:

  • OAuth Browser Flow (recommended for UI)
  • OAuth Token (for programmatic access)
  • Auth Provider (enterprise SSO)

Configuration Options

The following configuration options are available for this connector:

Configuration Parameters

Jira configuration schema.

project_keys
list[str]Required

List of Jira project keys to sync (e.g., ‘PROJ’, ‘DEV’, ‘MARKET’). Only the specified projects will be synced. Hit enter to add new project. You can find project keys in your Jira project settings.

Data Models

The following data models are available for this connector:

Schema for a Jira Project.

Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-projects/

FieldTypeDescription
project_idstrUnique numeric identifier for the project.
project_namestrDisplay name of the project.
project_keystrUnique key of the project (e.g., ‘PROJ’).
descriptionOptional[str]Description of the project.
web_url_valueOptional[str]Link to the project in Jira.

Schema for a Jira Issue.

Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/

FieldTypeDescription
issue_idstrUnique identifier for the issue.
issue_keystrJira key for the issue (e.g. ‘PROJ-123’).
summarystrShort summary field of the issue.
descriptionOptional[str]Detailed description of the issue.
statusOptional[str]Current workflow status of the issue.
issue_typeOptional[str]Type of the issue (bug, task, story, etc.).
project_keystrKey of the project that owns this issue.
created_timedatetimeTimestamp when the issue was created.
updated_timedatetimeTimestamp when the issue was last updated.
web_url_valueOptional[str]Link to the issue in Jira.