Registry /
workflow / apache-airflow-providers-asana
Install & Compatibility
Where this runs
tested against v2.11.4 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.920 runs
installs and imports cleanly · install 0.0s · import 0.000s · 254MB
glibcpy 3.10–3.920 runs
installs and imports cleanly · install 23.3s · import 0.000s · 252MB
254MB installed
● package 254MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
AsanaCreateTaskOperator
✓ from airflow.providers.asana.operators.asana_tasks import AsanaCreateTaskOperator
✗ from airflow.providers.asana.operators.asana import AsanaCreateTaskOperator
This example DAG demonstrates how to create an Asana task using the `AsanaCreateTaskOperator`. It highlights the use of `asana_conn_id` to refer to an Airflow connection configured with an Asana Personal Access Token. Remember to replace placeholder GIDs with your actual Asana Workspace and Project GIDs.
import os
from datetime import datetime
from airflow import DAG
from airflow.providers.asana.operators.asana import AsanaCreateTaskOperator
# Configure your Asana Personal Access Token in an Airflow connection
# with Conn Id 'asana_default' and 'Personal Access Token' as Login.
# For production, consider using Airflow Secrets Backend.
# Example values for workspace_id and project_id below are placeholders.
# Replace 'your_workspace_id' and 'your_project_id' with actual Asana GIDs.
ASANA_CONN_ID = 'asana_default'
ASANA_WORKSPACE_GID = os.environ.get('ASANA_WORKSPACE_GID', 'your_workspace_id') # Asana Workspace GID
ASANA_PROJECT_GID = os.environ.get('ASANA_PROJECT_GID', 'your_project_id') # Asana Project GID
with DAG(
dag_id='asana_task_creation_example',
start_date=datetime(2023, 1, 1),
schedule_interval=None,
catchup=False,
tags=['asana', 'example'],
) as dag:
create_asana_task = AsanaCreateTaskOperator(
task_id='create_new_asana_task',
asana_conn_id=ASANA_CONN_ID,
name='Airflow-created Task',
task_parameters={
'workspace': ASANA_WORKSPACE_GID,
'projects': [ASANA_PROJECT_GID],
'notes': 'This task was created by an Apache Airflow DAG.',
'due_on': '2026-04-30' # Example due date
}
)
Debug
Known issues
breakingProvider versions are tied to minimum Airflow versions. For example, provider `2.0.0` required Airflow `2.2.0+`, while the current `2.11.x` series requires Apache Airflow `>=2.11.0`.fixEnsure your `apache-airflow-providers-asana` version is compatible with your installed Apache Airflow version. Refer to the official provider documentation for the exact compatibility matrix.
affects: <2.11.0 (for current provider version)
deprecatedThe generic `AsanaOperator` class is deprecated. Users should use specific operators for distinct actions like creating, updating, deleting, or finding tasks.fixReplace `AsanaOperator` with `AsanaCreateTaskOperator`, `AsanaUpdateTaskOperator`, `AsanaDeleteTaskOperator`, or `AsanaFindTaskOperator` as appropriate for your task.
affects: All versions since 2.0.0 (where specific operators were introduced/emphasized)
gotchaThe Asana provider package must be installed on all Airflow components (scheduler, webserver, and workers) for it to function correctly across the entire Airflow deployment.fixEnsure `pip install apache-airflow-providers-asana` is executed in the environment of all relevant Airflow components, especially in Docker/Kubernetes setups.
affects: All
gotchaAuthentication to Asana requires an Asana Personal Access Token configured in an Airflow connection. Incorrectly configured connections will lead to authentication failures.fixCreate an Airflow connection of type 'Asana' in the Airflow UI. Set the `Conn Id` (e.g., `asana_default`) and paste your Personal Access Token into the 'Login' field. Ensure this `Conn Id` matches the `asana_conn_id` parameter in your operators.
affects: All
Upgrade
Version history
2.11.4latest on PyPI · released Jun 7, 2026
Audit
Dependencies
apache-airflowrequiredCore Airflow dependency, minimum version >=2.11.0 for this provider version.
asanarequiredPython client library for Asana API.
apache-airflow-providers-common-compatoptionalProvides common compatibility features across providers.