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 AACFlow.io, 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 AACFlow.io projects.
Integrate Asana into the workflow. Can read, write, and update tasks.
Retrieve a single task by GID or get multiple tasks with filters
Parameter Type Required Description taskGidstring No The globally unique identifier (GID) of the task. If not provided, will get multiple tasks. workspacestring No Asana workspace GID (numeric string) to filter tasks (required when not using taskGid) projectstring No Asana project GID (numeric string) to filter tasks limitnumber No Maximum number of tasks to return (default: 50)
Parameter Type Description successboolean Operation success status tsstring Timestamp of the response gidstring Task globally unique identifier resource_typestring Resource type (task) resource_subtypestring Resource subtype namestring Task name notesstring Task notes or description completedboolean Whether the task is completed assigneeobject Assignee details ↳ gid string Assignee GID ↳ name string Assignee name created_byobject Creator details ↳ gid string Creator GID ↳ name string Creator name due_onstring Due date (YYYY-MM-DD) created_atstring Task creation timestamp modified_atstring Task last modified timestamp tasksarray Array of tasks (when fetching multiple) ↳ gid string Task GID ↳ name string Task name ↳ completed boolean Completion status
Create a new task in Asana
Parameter Type Required Description workspacestring Yes Asana workspace GID (numeric string) where the task will be created namestring Yes Name of the task notesstring No Notes or description for the task assigneestring No User GID to assign the task to due_onstring No Due date in YYYY-MM-DD format
Parameter Type Description successboolean Operation success status tsstring Timestamp of the response gidstring Task globally unique identifier namestring Task name notesstring Task notes or description completedboolean Whether the task is completed created_atstring Task creation timestamp permalink_urlstring URL to the task in Asana
Update an existing task in Asana
Parameter Type Required Description taskGidstring Yes Asana task GID (numeric string) of the task to update namestring No Updated name for the task notesstring No Updated notes or description for the task assigneestring No Updated assignee user GID completedboolean No Mark task as completed or not completed due_onstring No Updated due date in YYYY-MM-DD format
Parameter Type Description successboolean Operation success status tsstring Timestamp of the response gidstring Task globally unique identifier namestring Task name notesstring Task notes or description completedboolean Whether the task is completed modified_atstring Task last modified timestamp
Retrieve all projects from an Asana workspace
Parameter Type Required Description workspacestring Yes Asana workspace GID (numeric string) to retrieve projects from
Parameter Type Description successboolean Operation success status tsstring Timestamp of the response projectsarray Array of projects ↳ gid string Project GID ↳ name string Project name ↳ resource_type string Resource type (project)
Search for tasks in an Asana workspace
Parameter Type Required Description workspacestring Yes Asana workspace GID (numeric string) to search tasks in textstring No Text to search for in task names assigneestring No Filter tasks by assignee user GID projectsarray No Array of Asana project GIDs (numeric strings) to filter tasks by completedboolean No Filter by completion status
Parameter Type Description successboolean Operation success status tsstring Timestamp of the response tasksarray Array of matching tasks ↳ gid string Task GID ↳ resource_type string Resource type ↳ resource_subtype string Resource subtype ↳ name string Task 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_pageobject Pagination info ↳ offset string Offset token ↳ path string API path ↳ uri string Full URI
Add a comment (story) to an Asana task
Parameter Type Required Description taskGidstring Yes Asana task GID (numeric string) textstring Yes The text content of the comment
Parameter Type Description successboolean Operation success status tsstring Timestamp of the response gidstring Comment globally unique identifier textstring Comment text content created_atstring Comment creation timestamp created_byobject Comment author details ↳ gid string Author GID ↳ name string Author name
Create a subtask under an existing Asana task
Parameter Type Required Description taskGidstring Yes GID of the parent Asana task (numeric string) namestring Yes Name of the subtask notesstring No Notes or description for the subtask assigneestring No User GID to assign the subtask to due_onstring No Due date in YYYY-MM-DD format
Parameter Type Description successboolean Operation success status tsstring Timestamp of the response gidstring Subtask globally unique identifier namestring Subtask name notesstring Subtask notes or description completedboolean Whether the subtask is completed created_atstring Subtask creation timestamp permalink_urlstring URL to the subtask in Asana
Delete an Asana task by its GID (moves it to the trash)
Parameter Type Required Description taskGidstring Yes GID of the Asana task to delete (numeric string)
Parameter Type Description successboolean Operation success status tsstring Timestamp of the response gidstring GID of the deleted task deletedboolean Whether the task was deleted
Add one or more followers to an Asana task
Parameter Type Required Description taskGidstring Yes GID of the Asana task (numeric string) followersarray Yes Array of user GIDs to add as followers to the task
Parameter Type Description successboolean Operation success status tsstring Timestamp of the response gidstring Task globally unique identifier namestring Task name followersarray Current followers on the task after the update ↳ gid string Follower GID ↳ name string Follower name
Create a new project in an Asana workspace
Parameter Type Required Description workspacestring Yes Asana workspace GID (numeric string) where the project will be created namestring Yes Name of the project notesstring No Notes or description for the project
Parameter Type Description successboolean Operation success status tsstring Timestamp of the response gidstring Project globally unique identifier namestring Project name notesstring Project notes or description archivedboolean Whether the project is archived colorstring Project color created_atstring Project creation timestamp modified_atstring Project last modified timestamp permalink_urlstring URL to the project in Asana
Retrieve a single Asana project by its GID
Parameter Type Required Description projectGidstring Yes Asana project GID (numeric string) to retrieve
Parameter Type Description successboolean Operation success status tsstring Timestamp of the response gidstring Project globally unique identifier namestring Project name notesstring Project notes or description archivedboolean Whether the project is archived colorstring Project color created_atstring Project creation timestamp modified_atstring Project last modified timestamp permalink_urlstring URL to the project in Asana
List all Asana workspaces and organizations the authenticated user belongs to
Parameter Type Required Description
Parameter Type Description successboolean Operation success status tsstring Timestamp of the response workspacesarray Array of workspaces ↳ gid string Workspace GID ↳ name string Workspace name ↳ resource_type string Resource type (workspace)
Create a new section in an Asana project
Parameter Type Required Description projectGidstring Yes GID of the Asana project (numeric string) to add the section to namestring Yes Name of the section
Parameter Type Description successboolean Operation success status tsstring Timestamp of the response gidstring Section globally unique identifier namestring Section name created_atstring Section creation timestamp
List all sections in an Asana project
Parameter Type Required Description projectGidstring Yes GID of the Asana project (numeric string) to list sections from
Parameter Type Description successboolean Operation success status tsstring Timestamp of the response sectionsarray Array of sections in the project ↳ gid string Section GID ↳ name string Section name ↳ resource_type string Resource type (section)