Asana

Interact with Asana

Asana 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.

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

ParameterTypeRequiredDescription
taskGidstringNoThe globally unique identifier (GID) of the task. If not provided, will get multiple tasks.
workspacestringNoAsana workspace GID (numeric string) to filter tasks (required when not using taskGid)
projectstringNoAsana project GID (numeric string) to filter tasks
limitnumberNoMaximum number of tasks to return (default: 50)

Output

ParameterTypeDescription
successbooleanOperation success status
tsstringTimestamp of the response
gidstringTask globally unique identifier
resource_typestringResource type (task)
resource_subtypestringResource subtype
namestringTask name
notesstringTask notes or description
completedbooleanWhether the task is completed
assigneeobjectAssignee details
gidstringAssignee GID
namestringAssignee name
created_byobjectCreator details
gidstringCreator GID
namestringCreator name
due_onstringDue date (YYYY-MM-DD)
created_atstringTask creation timestamp
modified_atstringTask last modified timestamp
tasksarrayArray of tasks (when fetching multiple)
gidstringTask GID
namestringTask name
completedbooleanCompletion status

asana_create_task

Create a new task in Asana

Input

ParameterTypeRequiredDescription
workspacestringYesAsana workspace GID (numeric string) where the task will be created
namestringYesName of the task
notesstringNoNotes or description for the task
assigneestringNoUser GID to assign the task to
due_onstringNoDue date in YYYY-MM-DD format

Output

ParameterTypeDescription
successbooleanOperation success status
tsstringTimestamp of the response
gidstringTask globally unique identifier
namestringTask name
notesstringTask notes or description
completedbooleanWhether the task is completed
created_atstringTask creation timestamp
permalink_urlstringURL to the task in Asana

asana_update_task

Update an existing task in Asana

Input

ParameterTypeRequiredDescription
taskGidstringYesAsana task GID (numeric string) of the task to update
namestringNoUpdated name for the task
notesstringNoUpdated notes or description for the task
assigneestringNoUpdated assignee user GID
completedbooleanNoMark task as completed or not completed
due_onstringNoUpdated due date in YYYY-MM-DD format

Output

ParameterTypeDescription
successbooleanOperation success status
tsstringTimestamp of the response
gidstringTask globally unique identifier
namestringTask name
notesstringTask notes or description
completedbooleanWhether the task is completed
modified_atstringTask last modified timestamp

asana_get_projects

Retrieve all projects from an Asana workspace

Input

ParameterTypeRequiredDescription
workspacestringYesAsana workspace GID (numeric string) to retrieve projects from

Output

ParameterTypeDescription
successbooleanOperation success status
tsstringTimestamp of the response
projectsarrayArray of projects
gidstringProject GID
namestringProject name
resource_typestringResource type (project)

asana_search_tasks

Search for tasks in an Asana workspace

Input

ParameterTypeRequiredDescription
workspacestringYesAsana workspace GID (numeric string) to search tasks in
textstringNoText to search for in task names
assigneestringNoFilter tasks by assignee user GID
projectsarrayNoArray of Asana project GIDs (numeric strings) to filter tasks by
completedbooleanNoFilter by completion status

Output

ParameterTypeDescription
successbooleanOperation success status
tsstringTimestamp of the response
tasksarrayArray of matching tasks
gidstringTask GID
resource_typestringResource type
resource_subtypestringResource subtype
namestringTask name
notesstringTask notes
completedbooleanCompletion status
assigneeobjectAssignee details
gidstringAssignee GID
namestringAssignee name
due_onstringDue date
created_atstringCreation timestamp
modified_atstringModified timestamp
next_pageobjectPagination info
offsetstringOffset token
pathstringAPI path
uristringFull URI

asana_add_comment

Add a comment (story) to an Asana task

Input

ParameterTypeRequiredDescription
taskGidstringYesAsana task GID (numeric string)
textstringYesThe text content of the comment

Output

ParameterTypeDescription
successbooleanOperation success status
tsstringTimestamp of the response
gidstringComment globally unique identifier
textstringComment text content
created_atstringComment creation timestamp
created_byobjectComment author details
gidstringAuthor GID
namestringAuthor name

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started