Asana Tasks API
The Asana Tasks API is a powerful tool that allows developers to programmatically manage tasks and projects within the Asana platform. With this API, users can create, update, and delete tasks, as well as assign tasks to users, set due dates, and track task progress. By integrating the Asana Tasks API into their applications, developers can streamline project management processes, improve communication, and increase productivity within their teams.
Operations 28
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Ask an LLM
“Which tags have been applied to a particular Asana task?”
“Can I see every label attached to one task?”
Tell an agent
Show the tags on task {task}.
List the labels attached to task {task}.
Ask an LLM
“How do I list tasks assigned to someone in a workspace?”
“Can I fetch only tasks modified since a certain date?”
Tell an agent
List tasks assigned to {assignee} in workspace {workspace}.
Get the tasks in project {project} that are incomplete or completed since {completed_since}.
Ask an LLM
“How do I create a new task in Asana?”
“Can I set the assignee, due date and project when I add a task?”
Tell an agent
Create a task called {task} in my workspace.
Add a new to-do with these details: {fields}.
Ask an LLM
“What does the full record of one task include?”
“Can I look up a task's notes, assignee and due date by its ID?”
Tell an agent
Show me the details of task {task}.
Fetch the complete record for task {task}.
Ask an LLM
“How can I change the due date or assignee on an existing task?”
“Can I mark a task complete through the API?”
Tell an agent
Mark task {task} as complete.
Change task {task} with these updates: {changes}.
Ask an LLM
“What happens to a task after I delete it — can it be recovered from trash?”
“Can I remove a task I no longer need?”
Tell an agent destructive · confirm first
Delete task {task}.
Move task {task} to the trash.
Ask an LLM
“Can I copy an existing task, including its subtasks and attachments?”
“Is duplicating a task done as a background job?”
Tell an agent
Duplicate task {task} with the name {settings}.
Make a copy of task {task}.
Ask an LLM
“How do I list every task in a project in priority order?”
“Can I limit a project's task list to tasks not yet done?”
Tell an agent
List the tasks in project {project}.
Show tasks in project {project} completed since {since} or still open.
GET
/sections/{section_gid}/tasks
List the tasks in a board section · Asana Get tasks from a section
#
Ask an LLM
“Which tasks sit in a particular column of my board?”
“Can I list only the cards in one board section?”
Tell an agent
List the tasks in section {section}.
Show open tasks in board column {section} completed since {since}.
Ask an LLM
“Which tasks carry a specific tag?”
“Can I find everything labeled with one tag?”
Tell an agent
List the tasks tagged {tag}.
Show every task that has tag {tag} applied.
GET
/user_task_lists/{user_task_list_gid}/tasks
List the tasks in someone's My Tasks · Asana Get tasks from a user task list
#
Ask an LLM
“What tasks are on a user's My Tasks list?”
“Can I pull only incomplete items from someone's My Tasks?”
Tell an agent
List the tasks in user task list {list}.
Show My Tasks items from list {list} that are open or completed since {since}.
Ask an LLM
“How do I see the subtasks under a task?”
“Can I get the child tasks broken out of a parent task?”
Tell an agent
List the subtasks of task {task}.
Show the child tasks under task {task}.
Ask an LLM
“How do I add a subtask to an existing task?”
“Can I break a task into smaller subtasks via the API?”
Tell an agent
Add a subtask named {subtask} under task {task}.
Create a child task beneath task {task} with these details: {fields}.
Ask an LLM
“Can I turn a standalone task into a subtask of another task?”
“Is there a way to move a subtask to a different parent or remove its parent?”
Tell an agent
Make task {task} a subtask of {parent}.
Detach task {task} from its parent so it has no parent task.
GET
/tasks/{task_gid}/dependencies
List what a task is waiting on · Asana Get dependencies from a task
#
Ask an LLM
“Which tasks must be finished before this one can start?”
“Can I see the dependencies blocking a task?”
Tell an agent
List the dependencies of task {task}.
Show which tasks task {task} is blocked by.
POST
/tasks/{task_gid}/addDependencies
Mark tasks as blockers of a task · Asana Set dependencies for a task
#
Ask an LLM
“How do I say a task can't start until other tasks are done?”
“Is there a cap on how many dependencies and dependents a task can have?”
Tell an agent
Make task {task} depend on tasks {dependencies}.
Mark {dependencies} as blocking task {task}.
POST
/tasks/{task_gid}/removeDependencies
Unlink blocking tasks from a task · Asana Unlink dependencies from a task
#
Ask an LLM
“Can I remove a blocker from a task's dependencies?”
“How do I stop a task from waiting on another task?”
Tell an agent
Unlink dependencies {dependencies} from task {task}.
Remove the blockers {dependencies} on task {task}.
Ask an LLM
“Which tasks are blocked until this task is done?”
“Can I see the downstream dependents of a task?”
Tell an agent
List the dependents of task {task}.
Show which tasks are waiting on task {task}.
POST
/tasks/{task_gid}/addDependents
Mark tasks as waiting on a task · Asana Set dependents for a task
#
Ask an LLM
“How do I make other tasks wait on this one?”
“Can I add several downstream dependents to a task at once?”
Tell an agent
Make tasks {dependents} dependents of task {task}.
Set {dependents} to wait until task {task} is finished.
POST
/tasks/{task_gid}/removeDependents
Unlink waiting tasks from a task · Asana Unlink dependents from a task
#
Ask an LLM
“Can I remove a dependent task so it no longer waits on this one?”
“How do I unlink downstream tasks from a blocker?”
Tell an agent
Unlink dependents {dependents} from task {task}.
Stop tasks {dependents} from waiting on task {task}.
Ask an LLM
“Can one task live in more than one project?”
“How do I put an existing task into a project at a specific position or section?”
Tell an agent
Add task {task} to project {project}.
Put task {task} into another project with placement {placement}.
POST
/tasks/{task_gid}/removeProject
Remove a task from a project · Asana Remove a project from a task
#
Ask an LLM
“Does removing a task from a project delete the task?”
“How do I take a task out of one of its projects?”
Tell an agent
Remove task {task} from project {project}.
Take task {task} out of project {project} but keep the task.
Ask an LLM
“How do I tag a task?”
“Can I apply an existing tag to a task?”
Tell an agent
Add tag {tag} to task {task}.
Label task {task} with tag {tag}.
Ask an LLM
“Can I take a tag off a task without deleting the tag?”
“What's the way to untag a single task?”
Tell an agent
Remove tag {tag} from task {task}.
Untag task {task} by removing {tag}.
Ask an LLM
“How do I add collaborators who get notified about a task?”
“Can I add several followers to a task in one call?”
Tell an agent
Add followers {followers} to task {task}.
Subscribe {followers} to updates on task {task}.
POST
/tasks/{task_gid}/removeFollowers
Remove followers from a task · Asana Remove followers from a task
#
Ask an LLM
“Can I stop someone from following a task?”
“What's returned after followers are taken off a task?”
Tell an agent
Remove followers {followers} from task {task}.
Unsubscribe {followers} from task {task}.
GET
/workspaces/{workspace_gid}/tasks/custom_id/{custom_id}
Look up a task by its custom ID · Asana Get a task for a given custom ID
#
Ask an LLM
“Can I find a task using its custom ID shortcode instead of its gid?”
“How do I resolve a ticket-style custom ID to the actual task?”
Tell an agent
Find the task with custom ID {custom_id} in workspace {workspace}.
Look up task {custom_id} by its shortcode in workspace {workspace}.
GET
/workspaces/{workspace_gid}/tasks/search
Search tasks in a workspace with advanced filters · Asana Search tasks in a workspace
#
Ask an LLM
“Can I search tasks by text, due date range and assignee like advanced search in the app?”
“Which tasks in my workspace are blocked or overdue?”
Tell an agent
Search workspace {workspace} for tasks matching {text}.
Find incomplete tasks in workspace {workspace} due before {due_before}.