Asana Handler - Starter Kit

Asana is a powerful project management platform designed to organize work, track tasks, and streamline team collaboration. Through the Asana API, developers can programmatically manage workspaces, users, projects, tasks, dependencies, and portfolios. The AsanaHandler provides a clean, asynchronous interface for integrating Asana capabilities into agentic and automation-driven workflows.

Example

To create the AsanaHandler object, initialize it with your Asana Personal Access Token (PAT). The handler authenticates using the Asana API client and exposes core operations as tools.

import os
from superagentx_handlers.asana import AsanaHandler

asana_handler = AsanaHandler(
    token=os.getenv("ASANA_ACCESS_TOKEN")
)

Get Workspaces:
Retrieves all Asana workspaces accessible to the authenticated user.

workspaces = await asana_handler.get_workspaces()
print(workspaces)

Tasks:
Create Task:
Creates a new task in a specified workspace with optional project, assignee, and due date.

task = await asana_handler.create_task(
    name="Design API documentation",
    workspace_id="123456789",
    project_id="987654321",
    assignee_id="1122334455",
    due_on="2026-02-10"
)
print(task)

Update Task:
Updates task details such as name, completion status, assignee, or due date.

updated_task = await asana_handler.update_task(
    task_id="123456789",
    completed=True
)
print(updated_task)

Delete Task:
Deletes a task permanently from Asana.

response = await asana_handler.delete_task(
    task_id="123456789"
)
print(response)

Users:
Get Users:
Retrieves all users across all accessible workspaces.

users = await asana_handler.get_users()
for user in users["data"]:
    print(user["name"])

Projects:
Get Projects:
Fetches all projects across accessible workspaces.

projects = await asana_handler.get_projects()
print(projects)

Task Dependencies:
Get Task Dependencies:
Retrieves tasks that must be completed before a given task.

dependencies = await asana_handler.get_dependencies_for_task(
    task_id="123456789"
)
print(dependencies)

Get Task Dependents:
Retrieves tasks that depend on the given task.

dependents = await asana_handler.get_dependents_for_task(
    task_id="123456789"
)
print(dependents)

Portfolios:
Get Portfolios:
Retrieves all portfolios across accessible workspaces and users.

portfolios = await asana_handler.get_portfolios()
print(portfolios)

​Example

Example