---
title: Asana
description: Interact with Asana
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="asana"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Asana](https://asana.com/) is a leading work management platform designed to help teams organize, track, and manage their tasks and projects more efficiently. With Asana, individuals and organizations can streamline project planning, delegate responsibilities, monitor progress, and collaborate seamlessly across different workspaces and projects.

With Asana, you can:

- **Create, assign, and update tasks**: Break down your work into actionable items, assign them to team members, and keep everyone on the same page.
- **Organize projects**: Group related tasks into projects, set deadlines, and visualize the flow of work from start to finish.
- **Set priorities and due dates**: Ensure important tasks are completed on time and stay aligned with your project goals.
- **Track progress and completion**: Monitor tasks as they move through various stages and quickly identify roadblocks.
- **Collaborate with your team**: Share notes, attach relevant resources, and communicate updates directly on tasks.

In Sim, the Asana integration enables your agents to programmatically interact with Asana through a suite of flexible tools described below. Your agents can retrieve, create, and update tasks, making it easy to automate project management workflows, synchronize status with other tools, or trigger actions based on Asana task events. Harness these tools to streamline your team's productivity and keep all your projects organized and up to date directly within your Sim projects.
{/* MANUAL-CONTENT-END */}


## Usage Instructions

Integrate Asana into the workflow. Can read, write, and update tasks.



## Tools

### `asana_get_task`

Retrieve a single task by GID or get multiple tasks with filters

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `taskGid` | string | No | The globally unique identifier \(GID\) of the task. If not provided, will get multiple tasks. |
| `workspace` | string | No | Workspace GID to filter tasks \(required when not using taskGid\) |
| `project` | string | No | Project GID to filter tasks |
| `limit` | number | No | Maximum number of tasks to return \(default: 50\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `ts` | string | Timestamp of the response |
| `gid` | string | Task globally unique identifier |
| `resource_type` | string | Resource type \(task\) |
| `resource_subtype` | string | Resource subtype |
| `name` | string | Task name |
| `notes` | string | Task notes or description |
| `completed` | boolean | Whether the task is completed |
| `assignee` | object | Assignee details |
| ↳ `gid` | string | Assignee GID |
| ↳ `name` | string | Assignee name |
| `created_by` | object | Creator details |
| ↳ `gid` | string | Creator GID |
| ↳ `name` | string | Creator name |
| `due_on` | string | Due date \(YYYY-MM-DD\) |
| `created_at` | string | Task creation timestamp |
| `modified_at` | string | Task last modified timestamp |
| `tasks` | array | Array of tasks \(when fetching multiple\) |
|   ↳ `gid` | string | Task GID |
|   ↳ `name` | string | Task name |
|   ↳ `completed` | boolean | Completion status |

### `asana_create_task`

Create a new task in Asana

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `workspace` | string | Yes | Workspace GID where the task will be created |
| `name` | string | Yes | Name of the task |
| `notes` | string | No | Notes or description for the task |
| `assignee` | string | No | User GID to assign the task to |
| `due_on` | string | No | Due date in YYYY-MM-DD format |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `ts` | string | Timestamp of the response |
| `gid` | string | Task globally unique identifier |
| `name` | string | Task name |
| `notes` | string | Task notes or description |
| `completed` | boolean | Whether the task is completed |
| `created_at` | string | Task creation timestamp |
| `permalink_url` | string | URL to the task in Asana |

### `asana_update_task`

Update an existing task in Asana

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `taskGid` | string | Yes | The globally unique identifier \(GID\) of the task to update |
| `name` | string | No | Updated name for the task |
| `notes` | string | No | Updated notes or description for the task |
| `assignee` | string | No | Updated assignee user GID |
| `completed` | boolean | No | Mark task as completed or not completed |
| `due_on` | string | No | Updated due date in YYYY-MM-DD format |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `ts` | string | Timestamp of the response |
| `gid` | string | Task globally unique identifier |
| `name` | string | Task name |
| `notes` | string | Task notes or description |
| `completed` | boolean | Whether the task is completed |
| `modified_at` | string | Task last modified timestamp |

### `asana_get_projects`

Retrieve all projects from an Asana workspace

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `workspace` | string | Yes | Workspace GID to retrieve projects from |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `ts` | string | Timestamp of the response |
| `projects` | array | Array of projects |
|   ↳ `gid` | string | Project GID |
|   ↳ `name` | string | Project name |
|   ↳ `resource_type` | string | Resource type \(project\) |

### `asana_search_tasks`

Search for tasks in an Asana workspace

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `workspace` | string | Yes | Workspace GID to search tasks in |
| `text` | string | No | Text to search for in task names |
| `assignee` | string | No | Filter tasks by assignee user GID |
| `projects` | array | No | Array of project GIDs to filter tasks by |
| `completed` | boolean | No | Filter by completion status |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `ts` | string | Timestamp of the response |
| `tasks` | array | Array of matching tasks |
|   ↳ `gid` | string | Assignee GID |
|   ↳ `resource_type` | string | Resource type |
|   ↳ `resource_subtype` | string | Resource subtype |
|   ↳ `name` | string | Assignee name |
|   ↳ `notes` | string | Task notes |
|   ↳ `completed` | boolean | Completion status |
|   ↳ `assignee` | object | Assignee details |
|   ↳ `gid` | string | Assignee GID |
|   ↳ `name` | string | Assignee name |
|   ↳ `due_on` | string | Due date |
|   ↳ `created_at` | string | Creation timestamp |
|   ↳ `modified_at` | string | Modified timestamp |
| `next_page` | object | Pagination info |
| ↳ `offset` | string | Offset token |
| ↳ `path` | string | API path |
| ↳ `uri` | string | Full URI |

### `asana_add_comment`

Add a comment (story) to an Asana task

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `taskGid` | string | Yes | The globally unique identifier \(GID\) of the task |
| `text` | string | Yes | The text content of the comment |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `ts` | string | Timestamp of the response |
| `gid` | string | Comment globally unique identifier |
| `text` | string | Comment text content |
| `created_at` | string | Comment creation timestamp |
| `created_by` | object | Comment author details |
| ↳ `gid` | string | Author GID |
| ↳ `name` | string | Author name |


