> ## Documentation Index
> Fetch the complete documentation index at: https://koreai-agentplatform-dev.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Using the Asana Action Templates

<Badge icon="arrow-left" color="gray">[Back to Actions Integrations](/ai-for-service/integrations/overview#actions)</Badge>

Use prebuilt Asana action templates to auto-create dialog tasks.

**Prerequisites:** Configure [Asana](/ai-for-service/integrations/actions/configuring-the-asana-action) and [install templates](/ai-for-service/integrations/actions/configuring-the-asana-action#install-asana-action-templates) before proceeding.

Navigate to **Automation AI > Use Cases > Dialogs**, then click the auto-created dialog to open the canvas with entity nodes, service nodes, and message scripts.

***

## Supported Actions

| Action                       | Description                        | Method |
| ---------------------------- | ---------------------------------- | ------ |
| Get a Task by ID             | Retrieves a task by task ID        | GET    |
| Find Tasks Created By a User | Retrieves tasks created by a user  | GET    |
| Find Tasks Assigned to User  | Retrieves tasks assigned to a user | GET    |
| List All Projects            | Returns all projects               | POST   |
| List All Users               | Returns all users                  | POST   |

***

## Get Task by ID

1. Install the template from [Asana Templates](/ai-for-service/integrations/actions/configuring-the-asana-action#install-asana-action-templates).

2. The **Get Task by Id** dialog task is added with:

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-action-img13.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=dc9f540042292edbc33a7c26e00f5e51" alt="Dialog task added" width="1535" height="852" data-path="ai-for-service/integrations/actions/images/asana-action-img13.png" />

   * **getTaskById** - User intent to fetch a task by ID.

   * **taskId** - Entity node for the task ID.

   * **getTaskByIdService** - Bot action service to fetch the task. Click **Edit Request** to modify parameters.

     <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana_template-img5.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=ff4a43b03e61e7357d0b80f87703b5d0" alt="Edit request" width="1917" height="904" data-path="ai-for-service/integrations/actions/images/asana_template-img5.png" />

     Click **+Add Response** to add sample responses:

     <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana_template-img6.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=672ec856b2c3f78fd79d147bffee643a" alt="Add Response" width="1919" height="911" data-path="ai-for-service/integrations/actions/images/asana_template-img6.png" />

     **Sample Response:**

     ```json theme={null}
     {
       "data": {
         "gid": "1204307990977944",
         "assignee": { "gid": "1204191722074650", "name": "Alan Walker" },
         "created_at": "2023-03-31T11:11:44.658Z",
         "created_by": { "gid": "1204191722074650", "name": "Alan Walker" },
         "name": "NEW TASK",
         "notes": "The description",
         "permalink_url": "https://app.asana.com/0/1xx60369/1XXX944",
         "projects": [{ "gid": "1204191735460369", "name": "Int1" }],
         "workspace": { "gid": "21968248715756", "name": "xyz.com" }
       }
     }
     ```

   * **getTaskByIdMessage** - Message node to display the task result.

3. Click **Train** to complete training.

4. Click **Talk to Bot** to test.

5. Enter the task ID when prompted.

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana_template-img7.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=744fc01348b9776b9cfd38281c26017c" alt="Enter Task ID" width="586" height="829" data-path="ai-for-service/integrations/actions/images/asana_template-img7.png" />

6. The task is returned. Click **View Task** to open it in Asana.

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana_template-img8.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=74d0f7994369260d383859f428f5e76d" alt="Task found with ID" width="584" height="837" data-path="ai-for-service/integrations/actions/images/asana_template-img8.png" />

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana_template-img9.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=bbe9c5cd34e5facd24288a1d785125ae" alt="View task" width="1916" height="832" data-path="ai-for-service/integrations/actions/images/asana_template-img9.png" />

***

## Find Tasks Created by a User

1. Install the template from [Asana Templates](/ai-for-service/integrations/actions/configuring-the-asana-action#install-asana-action-templates).

2. The **Find Tasks Created by User** dialog task is added with:

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-template-img10-find_tasks.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=ecd999a91993280476c71c6e97202309" alt="Dialog task" width="1525" height="899" data-path="ai-for-service/integrations/actions/images/asana-template-img10-find_tasks.png" />

   * **findTasksCreatedByUser** - User intent to retrieve tasks created by a user.

   * **workSpaceId** - Entity node for the workspace ID.

   * **userId** - Entity node for the user ID.

   * **findCreatedTasksService** - Bot action service to find created tasks. Click **+Add Response**:

     <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-template-img11-find_tasks2.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=bb86bbaa3a0c6357864cd8ca746091df" alt="Bot action service" width="1917" height="775" data-path="ai-for-service/integrations/actions/images/asana-template-img11-find_tasks2.png" />

     **Sample Response:**

     ```json theme={null}
     {
       "data": [
         {
           "gid": "1204325494675011",
           "assignee": { "gid": "12041917XXX0", "name": "Alan Walker" },
           "created_at": "2023-04-03T20:32:00.270Z",
           "name": "30Apr NEW TASK",
           "notes": "The description",
           "projects": [{ "gid": "1204191735460369", "name": "Int1" }],
           "workspace": { "gid": "21968248715756", "name": "xyz.com" }
         }
       ]
     }
     ```

   * **createdTaskMessage** - Message node to display results.

3. Click **Train**, then **Talk to Bot** to test.

4. Follow prompts to enter workspace ID and user ID.

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-template-img12-find_tasks5.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=d87eda269d5d0df220d0d1dbdee44655" alt="Find tasks with user ID" width="600" height="829" data-path="ai-for-service/integrations/actions/images/asana-template-img12-find_tasks5.png" />

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-template-img13-find_tasks6.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=f09522625ca253774b26dfc1b2592b74" alt="Enter user ID" width="597" height="837" data-path="ai-for-service/integrations/actions/images/asana-template-img13-find_tasks6.png" />

5. Click **View Task** to open in Asana.

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana_template-img14.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=b7c421c32c9a612f7986cef9ca741258" alt="View task" width="1916" height="832" data-path="ai-for-service/integrations/actions/images/asana_template-img14.png" />

***

## Find Tasks Assigned to a User

1. Install the template from [Asana Templates](/ai-for-service/integrations/actions/configuring-the-asana-action#install-asana-action-templates).

2. The **FindTasks Assigned to a User** dialog task is added with:

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-template-img15-find_task_assigned.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=75535a12cb688ec0addb268f892b9a49" alt="Dialog task" width="1532" height="906" data-path="ai-for-service/integrations/actions/images/asana-template-img15-find_task_assigned.png" />

   * **findTasksAssignedToUser** - User intent to retrieve tasks assigned to a user.

   * **workSpaceId** - Entity node for workspace ID.

   * **userId** - Entity node for user ID.

   * **findAssignedTasksService** - Bot action service to fetch assigned tasks. Click **+Add Response**:

     <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-template-img16-find_task_assigned1.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=a9d26132edbbb29c3c298bbc3a9b3416" alt="Bot action service" width="1913" height="902" data-path="ai-for-service/integrations/actions/images/asana-template-img16-find_task_assigned1.png" />

     **Sample Response:**

     ```json theme={null}
     {
       "data": [
         {
           "gid": "1204325494675011",
           "assignee": { "gid": "1204191722074650", "name": "Alan Walker" },
           "name": "30Apr NEW TASK",
           "projects": [{ "gid": "1204191735460369", "name": "Int1" }],
           "workspace": { "gid": "21968248715756", "name": "xyz.com" }
         }
       ]
     }
     ```

   * **assignedTaskMessage** - Message node to display results.

3. Click **Train**, then **Talk to Bot** to test.

4. Follow prompts to find tasks.

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-template-img17-find_task_assigned3.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=f898493b753e2ecf07233b57dda64673" alt="Find task" width="593" height="834" data-path="ai-for-service/integrations/actions/images/asana-template-img17-find_task_assigned3.png" />

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-template-img18-find_task_assigned4.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=1c493500c59add1b5b7eec509ed864dc" alt="Enter task ID" width="595" height="832" data-path="ai-for-service/integrations/actions/images/asana-template-img18-find_task_assigned4.png" />

5. Click **View Task** to open in Asana.

***

## List All Projects

1. Install the template from [Asana Templates](/ai-for-service/integrations/actions/configuring-the-asana-action#install-asana-action-templates).

2. The **List All Projects** dialog task is added with:

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-template-img19-list_all_projects.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=d89d177c3d7c79407941af22d50b1b68" alt="Dialog task" width="1432" height="907" data-path="ai-for-service/integrations/actions/images/asana-template-img19-list_all_projects.png" />

   * **listAllProjects** - User intent to retrieve all projects.

   * **listAllProjectsService** - Bot action service to retrieve all projects. Click **+Add Response**:

     <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-template-img20-list_all_projects1.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=93971a58004f61453de06a034f4637e1" alt="Bot action service" width="1917" height="817" data-path="ai-for-service/integrations/actions/images/asana-template-img20-list_all_projects1.png" />

     **Sample Response:**

     ```json theme={null}
     {
       "data": [
         {
           "gid": "1190334540433515",
           "name": "integration",
           "owner": { "gid": "1190337001098545", "name": "Alan" },
           "workspace": { "gid": "21968248715756", "name": "xyz.com" }
         }
       ]
     }
     ```

   * **listProjectMessage** - Message node to display results.

3. Click **Train**, then **Talk to Bot** to test.

4. Follow prompts to list projects.

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-template-img21-list_all_projects2.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=47b846eb4d3cb860aa20e32ca7cb23d7" alt="List projects prompt" width="597" height="839" data-path="ai-for-service/integrations/actions/images/asana-template-img21-list_all_projects2.png" />

5. Click **View Project** to open in Asana.

***

## List All Users

1. Install the template from [Asana Templates](/ai-for-service/integrations/actions/configuring-the-asana-action#install-asana-action-templates).

2. The **List All Users** dialog task is added with:

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-template-img22list_all_users.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=69afec417ba17a19e76177f9277cf7a1" alt="Dialog task" width="1446" height="907" data-path="ai-for-service/integrations/actions/images/asana-template-img22list_all_users.png" />

   * **listAllUsers** - User intent to retrieve all users.

   * **listAllUsersService** - Bot action service to find all users. Click **+Add Response**:

     <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-template-img23-list_all_users1.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=79a970d0f177401851f07b3f0d35015f" alt="Bot action service" width="1918" height="815" data-path="ai-for-service/integrations/actions/images/asana-template-img23-list_all_users1.png" />

     **Sample Response:**

     ```json theme={null}
     {
       "data": [
         {
           "gid": "11xxxx674034",
           "email": "alan.walker@xyz.com",
           "name": "Alan Walker",
           "workspaces": [{ "gid": "219xxx756", "name": "xyz.com" }]
         }
       ]
     }
     ```

   * **listAllUsersMessage** - Message node to display results.

3. Click **Train**, then **Talk to Bot** to test.

4. Follow prompts to list users.

   <img src="https://mintcdn.com/koreai-agentplatform-dev/kX2An6cZi-sfQWSk/ai-for-service/integrations/actions/images/asana-template-img24-list_all_users2.png?fit=max&auto=format&n=kX2An6cZi-sfQWSk&q=85&s=3cc202f47a6a09086b9aa1cec1ca0b58" alt="List users prompt" width="589" height="830" data-path="ai-for-service/integrations/actions/images/asana-template-img24-list_all_users2.png" />

5. Click **View User** to open in Asana.
