# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.