{"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":"python","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,"search_vec":"'-3':64 '2':63 '3.3.3':70 'airflow':2,9,17,54,71 'apach':1,8,16,53 'apache-airflow-providers-atlassian-jira':7 'atlassian':3,11,24,73 'autom':37,75 'cadenc':57 'communiti':48 'community-manag':47 'creation':41 'current':67 'enabl':20 'etl':76 'everi':62 'follow':52 'hook':31 'integr':22 'interact':33 'issu':40 'jira':4,12,25,35,72 'like':39 'manag':49 'minor':60 'monitor':44 'month':65 'offer':27 'oper':28 'packag':13 'provid':5,10,18,50,74 'releas':56,59 'seamless':21 'sensor':29 'task':38 'typic':58 'updat':42,61 'version':68","created_at":"2026-04-14T01:19:35.127747+00:00","updated_at":"2026-04-15T20:26:01.550999+00:00","problems":[{"fix":"Install the package using pip: 'pip install apache-airflow-providers-atlassian-jira'.","cause":"The 'apache-airflow-providers-atlassian-jira' package is not installed.","error":"ModuleNotFoundError: No module named 'airflow.providers.atlassian.jira'"},{"fix":"Ensure you are using the correct import statement as per the latest documentation: 'from airflow.providers.atlassian.jira.hooks.jira import JiraHook'.","cause":"The 'JiraHook' class has been moved or renamed in the 'apache-airflow-providers-atlassian-jira' package.","error":"ImportError: cannot import name 'JiraHook' from 'airflow.providers.atlassian.jira.hooks.jira'"},{"fix":"Verify that you have the correct version of 'apache-airflow-providers-atlassian-jira' installed and refer to the official documentation for the correct import path.","cause":"The 'JiraHook' class is not present in the specified module, possibly due to a version mismatch.","error":"AttributeError: module 'airflow.providers.atlassian.jira.hooks.jira' has no attribute 'JiraHook'"},{"fix":"Update your code to align with the latest 'JiraOperator' parameters as specified in the official documentation.","cause":"The 'JiraOperator' no longer accepts the 'jira_method' argument due to changes in the underlying SDK.","error":"TypeError: __init__() got an unexpected keyword argument 'jira_method'"},{"fix":"Ensure that the Jira connection ID is correctly set up in Airflow's connections and matches the ID used in your DAG.","cause":"The connection ID specified for Jira in Airflow does not exist or is misconfigured.","error":"ValueError: Invalid Jira connection ID provided."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"3.3.5","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/apache/airflow","docs":"https://airflow.apache.org/docs/apache-airflow-providers-atlassian-jira/3.3.3","changelog":"https://airflow.apache.org/docs/apache-airflow-providers-atlassian-jira/3.3.3/changelog.html","pypi":"https://pypi.org/project/apache-airflow-providers-atlassian-jira/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["workflow","crm-productivity"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-28","last_verified":"2026-08-30","next_check":"2026-07-28","install_tag":null}}