{"id":5109,"library":"apache-airflow-providers-atlassian-jira","title":"Apache Airflow Atlassian Jira Provider","description":"The `apache-airflow-providers-atlassian-jira` package is an Apache Airflow provider that enables seamless integration with Atlassian Jira. It offers operators, sensors, and hooks to interact with Jira for automating tasks like issue creation, updates, and monitoring. As a community-managed provider, it follows Apache Airflow's release cadence, typically releasing minor updates every 2-3 months. The current version is 3.3.3.","status":"active","version":"3.3.3","language":"en","source_language":"en","source_url":"https://github.com/apache/airflow/tree/main/airflow/providers/atlassian/jira","tags":["airflow","jira","atlassian","provider","automation","etl"],"install":[{"cmd":"pip install apache-airflow-providers-atlassian-jira","lang":"bash","label":"Install using pip"}],"dependencies":[{"reason":"Core dependency for all Airflow providers. Provider version 3.3.0+ requires Apache Airflow 2.11+.","package":"apache-airflow","optional":false}],"imports":[{"symbol":"JiraOperator","correct":"from airflow.providers.atlassian.jira.operators.jira import JiraOperator"},{"symbol":"JiraHook","correct":"from airflow.providers.atlassian.jira.hooks.jira import JiraHook"},{"symbol":"JiraSensor","correct":"from airflow.providers.atlassian.jira.sensors.jira import JiraSensor"}],"quickstart":{"code":"from __future__ import annotations\n\nimport os\nfrom datetime import datetime\n\nfrom airflow.models.dag import DAG\nfrom airflow.providers.atlassian.jira.operators.jira import JiraOperator\n\n# Ensure you have an Airflow Connection named 'jira_default' configured.\n# For a Jira API Token connection, use:\n# Conn Id: jira_default\n# Conn Type: Jira\n# Host: https://your-jira-instance.atlassian.net\n# Login: your_email@example.com\n# Password: your_api_token\n\nJIRA_CONN_ID = os.environ.get('AIRFLOW_JIRA_CONN_ID', 'jira_default')\nJIRA_PROJECT_KEY = os.environ.get('AIRFLOW_JIRA_PROJECT_KEY', 'YOUR_PROJECT_KEY')\n\nwith DAG(\n    dag_id='jira_create_issue_example',\n    start_date=datetime(2023, 1, 1),\n    schedule=None,\n    catchup=False,\n    tags=['jira', 'example'],\n) as dag:\n    create_jira_issue = JiraOperator(\n        task_id='create_jira_issue',\n        jira_conn_id=JIRA_CONN_ID,\n        jira_method='create_issue',\n        jira_method_args={\n            'fields': {\n                'project': {'key': JIRA_PROJECT_KEY},\n                'summary': 'Airflow Automated Issue: Task Completed',\n                'description': 'This issue was created by an Airflow DAG to log a completed task.',\n                'issuetype': {'name': 'Task'},\n            }\n        },\n    )\n","lang":"python","description":"This example DAG demonstrates how to create a Jira issue using the `JiraOperator`. It requires a pre-configured Airflow connection to Jira, typically using API Token authentication. Replace `YOUR_PROJECT_KEY` with an actual Jira project key."},"warnings":[{"fix":"Review and update your `JiraOperator` and `JiraHook` usages to conform to the `atlassian-python-api` SDK's methods and parameter structure. Ensure `jira_method` and `jira_method_args` are correctly specified for operators.","message":"The Jira provider migrated from the legacy `Atlassian Jira SDK` to the `atlassian-python-api` SDK in version 2.0.0. This significantly changed how interactions are structured. `JiraHook.get_conn` now returns an `atlassian.Jira` object instead of a `jira.Jira` object. `JiraOperator` now requires `jira_method` and `jira_method_args` arguments, aligning with the new SDK's method calls.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Upgrade your Apache Airflow environment to at least version 2.11.0 to use the latest features and bug fixes of this provider. Check the `PROVIDERS.rst` in the Apache Airflow GitHub repository for the most current compatibility matrix.","message":"Minimum Airflow version compatibility has increased. Provider version 3.1.0 requires Airflow 2.10+, and provider version 3.3.0+ requires Airflow 2.11+.","severity":"breaking","affected_versions":">=3.1.0, >=3.3.0"},{"fix":"Migrate to `apache-airflow-providers-atlassian-jira` by updating your `pip install` commands and import paths (e.g., `from airflow.providers.jira...` becomes `from airflow.providers.atlassian.jira...`).","message":"The `apache-airflow-providers-jira` package (note: without `atlassian` in the name) is deprecated as of version 3.1.0 in favor of `apache-airflow-providers-atlassian-jira`.","severity":"deprecated","affected_versions":"All versions of `apache-airflow-providers-jira` >=3.1.0"},{"fix":"Remove `validate` and `get_server_info` keys from the 'Extra' field of your Jira Airflow connections. Rely on the connection's host, login, password, and optional settings like `verify_ssl`.","message":"Due to the SDK migration, the `validate` and `get_server_info` keys in the Jira connection's 'Extra' JSON field are no longer supported.","severity":"gotcha","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-04-13T00:00:00.000Z","next_check":"2026-07-12T00:00:00.000Z"}