AACFlow

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

Usage Instructions

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

Actions

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

asana_create_subtask

Create a subtask under an existing Asana task

Input

ParameterTypeRequiredDescription
taskGidstringYesGID of the parent Asana task (numeric string)
namestringYesName of the subtask
notesstringNoNotes or description for the subtask
assigneestringNoUser GID to assign the subtask to
due_onstringNoDue date in YYYY-MM-DD format

Output

ParameterTypeDescription
successbooleanOperation success status
tsstringTimestamp of the response
gidstringSubtask globally unique identifier
namestringSubtask name
notesstringSubtask notes or description
completedbooleanWhether the subtask is completed
created_atstringSubtask creation timestamp
permalink_urlstringURL to the subtask in Asana

asana_delete_task

Delete an Asana task by its GID (moves it to the trash)

Input

ParameterTypeRequiredDescription
taskGidstringYesGID of the Asana task to delete (numeric string)

Output

ParameterTypeDescription
successbooleanOperation success status
tsstringTimestamp of the response
gidstringGID of the deleted task
deletedbooleanWhether the task was deleted

asana_add_followers

Add one or more followers to an Asana task

Input

ParameterTypeRequiredDescription
taskGidstringYesGID of the Asana task (numeric string)
followersarrayYesArray of user GIDs to add as followers to the task

Output

ParameterTypeDescription
successbooleanOperation success status
tsstringTimestamp of the response
gidstringTask globally unique identifier
namestringTask name
followersarrayCurrent followers on the task after the update
gidstringFollower GID
namestringFollower name

asana_create_project

Create a new project in an Asana workspace

Input

ParameterTypeRequiredDescription
workspacestringYesAsana workspace GID (numeric string) where the project will be created
namestringYesName of the project
notesstringNoNotes or description for the project

Output

ParameterTypeDescription
successbooleanOperation success status
tsstringTimestamp of the response
gidstringProject globally unique identifier
namestringProject name
notesstringProject notes or description
archivedbooleanWhether the project is archived
colorstringProject color
created_atstringProject creation timestamp
modified_atstringProject last modified timestamp
permalink_urlstringURL to the project in Asana

asana_get_project

Retrieve a single Asana project by its GID

Input

ParameterTypeRequiredDescription
projectGidstringYesAsana project GID (numeric string) to retrieve

Output

ParameterTypeDescription
successbooleanOperation success status
tsstringTimestamp of the response
gidstringProject globally unique identifier
namestringProject name
notesstringProject notes or description
archivedbooleanWhether the project is archived
colorstringProject color
created_atstringProject creation timestamp
modified_atstringProject last modified timestamp
permalink_urlstringURL to the project in Asana

asana_list_workspaces

List all Asana workspaces and organizations the authenticated user belongs to

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
successbooleanOperation success status
tsstringTimestamp of the response
workspacesarrayArray of workspaces
gidstringWorkspace GID
namestringWorkspace name
resource_typestringResource type (workspace)

asana_create_section

Create a new section in an Asana project

Input

ParameterTypeRequiredDescription
projectGidstringYesGID of the Asana project (numeric string) to add the section to
namestringYesName of the section

Output

ParameterTypeDescription
successbooleanOperation success status
tsstringTimestamp of the response
gidstringSection globally unique identifier
namestringSection name
created_atstringSection creation timestamp

asana_list_sections

List all sections in an Asana project

Input

ParameterTypeRequiredDescription
projectGidstringYesGID of the Asana project (numeric string) to list sections from

Output

ParameterTypeDescription
successbooleanOperation success status
tsstringTimestamp of the response
sectionsarrayArray of sections in the project
gidstringSection GID
namestringSection name
resource_typestringResource type (section)

On this page