> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Asana

> Connect Asana to your Atako agents — 20 read and 19 write actions.

Let your agents manage work in Asana — create and update tasks, projects, sections, tags and comments on your behalf.

## Connection

* **Authentication**: API key (Personal access token).

<Note>
  Asana → click your profile photo → Settings → Apps → Manage developer apps (or open app.asana.com/0/developer-console) → Personal access tokens → "Create new token" → name it and copy the token (starts with "1/", shown only once). The token inherits your Asana permissions — no scopes to configure.

  See [Asana's documentation](https://app.asana.com/0/developer-console).
</Note>

## Read actions (20)

| Action                        | Description                                                                      |
| ----------------------------- | -------------------------------------------------------------------------------- |
| `get_attachment`              | Fetch a single attachment record, including its download URL.                    |
| `get_project`                 | Fetch a single project by its GID.                                               |
| `get_section`                 | Fetch a single section by its GID.                                               |
| `get_tag`                     | Fetch a single tag by its GID.                                                   |
| `get_task`                    | Fetch a single task by its GID.                                                  |
| `get_team`                    | Fetch a single team by its GID.                                                  |
| `get_user`                    | Fetch a user by GID, email, or "me" for the connected user.                      |
| `get_workspace`               | Fetch a single workspace by its GID.                                             |
| `list_attachments_for_object` | List the attachments on a task, project, or project brief.                       |
| `list_projects_for_team`      | List the projects in a team.                                                     |
| `list_projects_for_workspace` | List the projects in a workspace.                                                |
| `list_sections_for_project`   | List the sections of a project.                                                  |
| `list_stories_for_task`       | List the stories (comments and activity) on a task.                              |
| `list_subtasks`               | List the subtasks of a task.                                                     |
| `list_tags_for_workspace`     | List the tags in a workspace.                                                    |
| `list_tasks_for_project`      | List the tasks in a project.                                                     |
| `list_teams_for_workspace`    | List the teams visible to the connected user in a workspace.                     |
| `list_users_for_workspace`    | List the users in a workspace or organization.                                   |
| `list_workspaces`             | List the workspaces visible to the connected user.                               |
| `search_tasks`                | Search tasks in a workspace with full-text and filters (requires Asana premium). |

## Write actions (19)

| Action                     | Description                                                                   |
| -------------------------- | ----------------------------------------------------------------------------- |
| `add_project_to_task`      | Add a task to a project, optionally in a specific section or position.        |
| `add_tag_to_task`          | Add a tag to a task.                                                          |
| `add_task_to_section`      | Move a task into a section of its project.                                    |
| `create_project`           | Create a project in a workspace or team.                                      |
| `create_section`           | Create a section in a project.                                                |
| `create_story_on_task`     | Post a comment (story) on a task.                                             |
| `create_subtask`           | Create a subtask under an existing task.                                      |
| `create_tag`               | Create a tag in a workspace.                                                  |
| `create_task`              | Create a task (requires a workspace, a project, or a parent task).            |
| `delete_attachment`        | Delete an attachment from its parent object.                                  |
| `delete_project`           | Delete a project (its tasks are not deleted).                                 |
| `delete_section`           | Delete an empty section from its project.                                     |
| `delete_story`             | Delete a comment story created by the connected user.                         |
| `delete_tag`               | Delete a tag (tasks keep their other tags).                                   |
| `delete_task`              | Delete a task (moved to trash, recoverable for 30 days in Asana).             |
| `remove_project_from_task` | Remove a task from a project (the task itself is kept).                       |
| `remove_tag_from_task`     | Remove a tag from a task.                                                     |
| `update_project`           | Update fields of an existing project.                                         |
| `update_task`              | Update fields of an existing task (name, notes, assignee, dates, completion). |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.