> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/context/overview/project-management/asana.md).

# Asana

The Asana Integration step allows you to connect your AirOps workflows with Asana projects. This native integration provides comprehensive task management, project organization, and team collaboration capabilities directly from your workflows.

## Overview

Asana is a work management platform that helps teams organize, track, and manage their work. By connecting Asana to AirOps, you can automate task creation, project updates, and team coordination.

## Authentication

Before using the Asana integration in your workflows, you must first connect your Asana account in the AirOps Settings:

1. Navigate to **Settings > Integrations**
2. Find the Asana section and click "Configure"
3. Authenticate with your Asana account
4. Grant AirOps access to your workspaces

## Available Actions

### Task Management

* **Create Task** -- add a new task to a project
* **Update Task** -- modify an existing task's details, status, or assignees
* **Delete Task** -- remove a task from a project
* **Find Task** -- locate a specific task by ID
* **Search Tasks** -- search for tasks across projects using filters

### Subtasks & Templates

* **Create Subtask** -- add subtasks to break down larger tasks
* **Create Task from Template** -- spin up tasks from predefined templates

### Projects & Sections

* **List Projects** -- retrieve all projects in a workspace
* **Search Sections** -- find sections within a project
* **Add Task to Section** -- organize tasks by moving them to specific sections

### Collaboration

* **Add Comment** -- add comments to tasks for team communication
* **Get Task Stories** -- view the activity history and comments on a task

### Personal Workflow

* **Get My Tasks** -- fetch tasks assigned to the authenticated user for personalized views

## Common Use Cases

* Automatically creating tasks for content review with proper sections
* Tracking content production workflows with subtasks for each phase
* Managing editorial calendars using templates for recurring content
* Coordinating team assignments for AI-generated content
* Adding workflow results as comments on existing tasks
* Building personalized dashboards by fetching user-specific tasks

{% hint style="info" %}
Note: Asana integration requires appropriate workspace permissions. Ensure your Asana account has access to the projects you want to connect.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.airops.com/context/overview/project-management/asana.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.