# Asana

eesel AI connects with Asana so your AI can automatically create tasks, update projects, and keep your team organized - all from within your existing helpdesk or chat workflows.<br>

<figure><img src="/files/JnJs7w38EQkn7vt6GYLQ" alt=""><figcaption></figcaption></figure>

## What you can do

* Provide status updates on tasks and projects
* Comment on tasks with relevant information
* Cite specific task assigness, due dates, and status
* Answer team questions about ongoing work in Slack or Teams
* Stay current as tasks are created, updated, or completed

{% hint style="info" %}
Note on sources: Asana is currently an **action only** integration. The AI cannot be trained on Asana project content. The AI can create and update your tasks, but does not index your Asana workspace as a knowledge source.
{% endhint %}

## Connecting Asana

{% stepper %}
{% step %}

### Go to your eesel dashboard and choose the agent you want to connect

You can connect with multiple agents if you want to.
{% endstep %}

{% step %}

### Click the integrations tab > Asana

{% endstep %}

{% step %}

### Follow the integration steps via Pipedream and grant access

The Pipedream flow should walk you through each auth step.
{% endstep %}

{% step %}

### Configure your integration triggers and actions

Click Asana from the list of integrations on the left sidebar of the eesel dashboard. From there, you can edit your triggers and actions. Select the ones you want to use and explain in the instructions how they should be used and when.
{% endstep %}

{% step %}

### Test your integration

Click an onboarding task, or ask in the sidebar chat to test an action

<figure><img src="/files/wdMRyUlQxzXk2mrtEWC5" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Confirm the integration works

<figure><img src="/files/aROwEqVcAF6aiLkjTgNU" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Actions <a href="#actions" id="actions"></a>

| Action                    | Description                                                                                                                    |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Update task               | Updates a specific and existing task                                                                                           |
| Get list of user projects | Return a list of projects given the user and workspace grid                                                                    |
| Search tasks              | Searches for a task by name within a project                                                                                   |
| Search tasks Premium      | Searches for a task by name, assignee, section, project, completed since, and modified since. Requires a Premium Asana account |
| Search sections           | Searches for a section by name within a particular project                                                                     |
| Search projects           | Finds an existing project                                                                                                      |
| List task stories         | Lists stories (including comments) for a task                                                                                  |
| Get tasks from task list  | Returns the compact list of tasks in a user's My Tasks list                                                                    |
| Find task by ID           | Searches for a task by ID. Returns the complete task record for a single task                                                  |
| Delete task               | Deletes a specific and existing task                                                                                           |
| Create task               | Creates a new task                                                                                                             |
| Create task from template | Creates a new task from a task template                                                                                        |
| Create task comment       | Adds a comment to a task                                                                                                       |
| Create subtask            | Creates a new subtask and adds it to the parent task                                                                           |
| Create project            | Create a new project in a workspace or team                                                                                    |
| Add task to section       | Add a task to a specific, existing section. This will remove the task from the other section                                   |


---

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

```
GET https://docs.eesel.ai/integrations/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.
