> ## Documentation Index
> Fetch the complete documentation index at: https://koreai-content-gov.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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-action-img13.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=1eff9f08f6041940a4e92eed5e2f677e" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana_template-img5.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=8be90600445b4dbdae5d4009ff482de6" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana_template-img6.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=fb89ff6fd95fe56ed07aa6f6c07288b7" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana_template-img7.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=78fa5889258540a73c4db653fe8e1242" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana_template-img8.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=e1dc3e2c76ea701014ada5e902c4f68a" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana_template-img9.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=1dd196885a72b79fe4ae00698a2b7e7e" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-template-img10-find_tasks.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=92e1458ccbe063e81570fff13e3605fe" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-template-img11-find_tasks2.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=d5365de343ce9f3ef38cfe4d58289805" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-template-img12-find_tasks5.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=6e48b62d2b59795cbed3b030da098341" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-template-img13-find_tasks6.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=fbd946832d95a95ecb2562a18b058c45" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana_template-img14.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=8e57fbb37853490b02fbc518e437e2d6" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-template-img15-find_task_assigned.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=c17ca84ff13125f5e9198adbb27eb116" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-template-img16-find_task_assigned1.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=6790c620b868821f82984c0d73cb3046" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-template-img17-find_task_assigned3.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=905e4a46153da1c91a795073d75fca24" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-template-img18-find_task_assigned4.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=e789bf95a07bfd098bf527b864737fee" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-template-img19-list_all_projects.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=caa99a875ee56677aa37ebafa20bd142" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-template-img20-list_all_projects1.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=0081931cd0d6fe5cbff85b5621121bd5" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-template-img21-list_all_projects2.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=5baa6a6313de0d49c393d6e29807db64" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-template-img22list_all_users.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=ecbfb0d6e650356d687c33fc20dc84fd" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-template-img23-list_all_users1.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=40b657b52c1667605f2203376a16d5f2" 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-content-gov/1m0dVm9sqatG8z03/ai-for-service/integrations/actions/images/asana-template-img24-list_all_users2.png?fit=max&auto=format&n=1m0dVm9sqatG8z03&q=85&s=0f629abd034d5aefcbf1d169d209f9fc" 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.
