Skip to main content
Server path: /asana-tasks | Type: Application | PCID required: Yes

​
Tools

ToolDescription
asana_tasks_add_dependencies_for_taskSet dependencies for a task
asana_tasks_add_dependents_for_taskSet dependents for a task
asana_tasks_add_followers_for_taskAdd followers to a task
asana_tasks_add_project_for_taskAdd a project to a task
asana_tasks_add_tag_for_taskAdd a tag to a task
asana_tasks_create_subtask_for_taskCreate a subtask
asana_tasks_create_taskCreate a task
asana_tasks_delete_taskDelete a task
asana_tasks_delete_task_templateDelete a task template
asana_tasks_duplicate_taskDuplicate a task
asana_tasks_get_dependencies_for_taskGet dependencies from a task
asana_tasks_get_dependents_for_taskGet dependents from a task
asana_tasks_get_for_projectGet tasks from a project
asana_tasks_get_for_sectionGet tasks from a section
asana_tasks_get_for_tagGet tasks from a tag
asana_tasks_get_for_user_task_listGet tasks from a user task list
asana_tasks_get_subtasks_for_taskGet subtasks from a task
asana_tasks_get_taskGet a task
asana_tasks_get_task_for_custom_idGet a task for a given custom ID
asana_tasks_get_task_templateGet a task template
asana_tasks_get_task_templatesGet multiple task templates
asana_tasks_get_tasksGet multiple tasks
asana_tasks_instantiate_taskInstantiate a task from a task template
asana_tasks_remove_dependencies_for_taskUnlink dependencies from a task
asana_tasks_remove_dependents_for_taskUnlink dependents from a task
asana_tasks_remove_follower_for_taskRemove followers from a task
asana_tasks_remove_project_for_taskRemove a project from a task
asana_tasks_remove_tag_for_taskRemove a tag from a task
asana_tasks_search_tasks_for_workspaceSearch tasks in a workspace
asana_tasks_set_parent_for_taskSet the parent of a task
asana_tasks_update_taskUpdate a task

​
asana_tasks_add_dependencies_for_task

Set dependencies for a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
dataobjectNo—The data value

​
asana_tasks_add_dependents_for_task

Set dependents for a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
dataobjectNo—A set of dependent tasks.

​
asana_tasks_add_followers_for_task

Add followers to a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
dataobjectNo—The data value

​
asana_tasks_add_project_for_task

Add a project to a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
dataobjectNo—The data value

​
asana_tasks_add_tag_for_task

Add a tag to a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
dataobjectNo—The data value

​
asana_tasks_create_subtask_for_task

Create a subtask Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
dataobjectNo—The data value

​
asana_tasks_create_task

Create a task Parameters:
ParameterTypeRequiredDefaultDescription
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
dataobjectNo—The data value

​
asana_tasks_delete_task

Delete a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.

​
asana_tasks_delete_task_template

Delete a task template Parameters:
ParameterTypeRequiredDefaultDescription
task_template_gidstringYes—Globally unique identifier for the task template.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.

​
asana_tasks_duplicate_task

Duplicate a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
dataobjectNo—The data value

​
asana_tasks_get_dependencies_for_task

Get dependencies from a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
limitintegerNo—Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstringNo—Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

​
asana_tasks_get_dependents_for_task

Get dependents from a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
limitintegerNo—Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstringNo—Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

​
asana_tasks_get_for_project

Get tasks from a project Parameters:
ParameterTypeRequiredDefaultDescription
completed_sincestringNo—Only return tasks that are either incomplete or that have been completed since this time. Accepts a date-time string or the keyword now.
project_gidstringYes—Globally unique identifier for the project.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
limitintegerNo—Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstringNo—Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

​
asana_tasks_get_for_section

Get tasks from a section Parameters:
ParameterTypeRequiredDefaultDescription
section_gidstringYes—The globally unique identifier for the section.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
limitintegerNo—Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstringNo—Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
completed_sincestringNo—Only return tasks that are either incomplete or that have been completed since this time. Accepts a date-time string or the keyword now.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

​
asana_tasks_get_for_tag

Get tasks from a tag Parameters:
ParameterTypeRequiredDefaultDescription
tag_gidstringYes—Globally unique identifier for the tag.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
limitintegerNo—Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstringNo—Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

​
asana_tasks_get_for_user_task_list

Get tasks from a user task list Parameters:
ParameterTypeRequiredDefaultDescription
completed_sincestringNo—Only return tasks that are either incomplete or that have been completed since this time. Accepts a date-time string or the keyword now.
user_task_list_gidstringYes—Globally unique identifier for the user task list.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
limitintegerNo—Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstringNo—Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

​
asana_tasks_get_subtasks_for_task

Get subtasks from a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
limitintegerNo—Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstringNo—Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

​
asana_tasks_get_task

Get a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

​
asana_tasks_get_task_for_custom_id

Get a task for a given custom ID Parameters:
ParameterTypeRequiredDefaultDescription
workspace_gidstringYes—Globally unique identifier for the workspace or organization.
custom_idstringYes—Generated custom ID for a task.

​
asana_tasks_get_task_template

Get a task template Parameters:
ParameterTypeRequiredDefaultDescription
task_template_gidstringYes—Globally unique identifier for the task template.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

​
asana_tasks_get_task_templates

Get multiple task templates Parameters:
ParameterTypeRequiredDefaultDescription
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
limitintegerNo—Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstringNo—Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
projectstringNo—The project to filter task templates on.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

​
asana_tasks_get_tasks

Get multiple tasks Parameters:
ParameterTypeRequiredDefaultDescription
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
limitintegerNo—Results per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstringNo—Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
assigneestringNo—The assignee to filter tasks on. If searching for unassigned tasks, assignee.any = null can be specified. Note: If you specify assignee, you must also specify the workspace to filter on.
projectstringNo—The project to filter tasks on.
sectionstringNo—The section to filter tasks on.
workspacestringNo—The workspace to filter tasks on. Note: If you specify workspace, you must also specify the assignee to filter on.
completed_sincestringNo—Only return tasks that are either incomplete or that have been completed since this time.
modified_sincestringNo—Only return tasks that have been modified since the given time. Note: A task is considered “modified” if any of its properties change, or associations between it and other objects are modified (e.g. a task being added to a project). A task is not considered modified just because another object it is associated with (e.g. a subtask) is modified. Actions that count as modifying the task include assigning, renaming, completing, and adding stories.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

​
asana_tasks_instantiate_task

Instantiate a task from a task template Parameters:
ParameterTypeRequiredDefaultDescription
task_template_gidstringYes—Globally unique identifier for the task template.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
dataobjectNo—The data value

​
asana_tasks_remove_dependencies_for_task

Unlink dependencies from a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
dataobjectNo—The data value

​
asana_tasks_remove_dependents_for_task

Unlink dependents from a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
dataobjectNo—A set of dependent tasks.

​
asana_tasks_remove_follower_for_task

Remove followers from a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
dataobjectNo—The data value

​
asana_tasks_remove_project_for_task

Remove a project from a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
dataobjectNo—The data value

​
asana_tasks_remove_tag_for_task

Remove a tag from a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
dataobjectNo—The data value

​
asana_tasks_search_tasks_for_workspace

Search tasks in a workspace Parameters:
ParameterTypeRequiredDefaultDescription
workspace_gidstringYes—Globally unique identifier for the workspace or organization.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
textstringNo—Performs full-text search on both task name and description
resource_subtypestringNo—Filters results by the task’s resource_subtype
assignee.anystringNo—Comma-separated list of user identifiers
assignee.notstringNo—Comma-separated list of user identifiers
portfolios.anystringNo—Comma-separated list of portfolio IDs
projects.anystringNo—Comma-separated list of project IDs
projects.notstringNo—Comma-separated list of project IDs
projects.allstringNo—Comma-separated list of project IDs
sections.anystringNo—Comma-separated list of section or column IDs
sections.notstringNo—Comma-separated list of section or column IDs
sections.allstringNo—Comma-separated list of section or column IDs
tags.anystringNo—Comma-separated list of tag IDs
tags.notstringNo—Comma-separated list of tag IDs
tags.allstringNo—Comma-separated list of tag IDs
teams.anystringNo—Comma-separated list of team IDs
followers.anystringNo—Comma-separated list of user identifiers
followers.notstringNo—Comma-separated list of user identifiers
created_by.anystringNo—Comma-separated list of user identifiers
created_by.notstringNo—Comma-separated list of user identifiers
assigned_by.anystringNo—Comma-separated list of user identifiers
assigned_by.notstringNo—Comma-separated list of user identifiers
liked_by.notstringNo—Comma-separated list of user identifiers
commented_on_by.notstringNo—Comma-separated list of user identifiers
due_on.beforestringNo—ISO 8601 date string
due_on.afterstringNo—ISO 8601 date string
due_onstringNo—ISO 8601 date string or null
due_at.beforestringNo—ISO 8601 datetime string
due_at.afterstringNo—ISO 8601 datetime string
start_on.beforestringNo—ISO 8601 date string
start_on.afterstringNo—ISO 8601 date string
start_onstringNo—ISO 8601 date string or null
created_on.beforestringNo—ISO 8601 date string
created_on.afterstringNo—ISO 8601 date string
created_onstringNo—ISO 8601 date string or null
created_at.beforestringNo—ISO 8601 datetime string
created_at.afterstringNo—ISO 8601 datetime string
completed_on.beforestringNo—ISO 8601 date string
completed_on.afterstringNo—ISO 8601 date string
completed_onstringNo—ISO 8601 date string or null
completed_at.beforestringNo—ISO 8601 datetime string
completed_at.afterstringNo—ISO 8601 datetime string
modified_on.beforestringNo—ISO 8601 date string
modified_on.afterstringNo—ISO 8601 date string
modified_onstringNo—ISO 8601 date string or null
modified_at.beforestringNo—ISO 8601 datetime string
modified_at.afterstringNo—ISO 8601 datetime string
is_blockingbooleanNo—Filter to incomplete tasks with dependents
is_blockedbooleanNo—Filter to tasks with incomplete dependencies
has_attachmentbooleanNo—Filter to tasks with attachments
completedbooleanNo—Filter to completed tasks
is_subtaskbooleanNo—Filter to subtasks
sort_bystringNo—One of due_date, created_at, completed_at, likes, or modified_at, defaults to modified_at
sort_ascendingbooleanNo—Default false
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

​
asana_tasks_set_parent_for_task

Set the parent of a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
dataobjectNo—The data value

​
asana_tasks_update_task

Update a task Parameters:
ParameterTypeRequiredDefaultDescription
task_gidstringYes—The task to operate on.
opt_prettybooleanNo—Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]No—This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
dataobjectNo—The data value