Skip to main content

List Tasks

Returns the compact task records for some filtered set of tasks. Use one or more of the parameters provided to filter the tasks returned. You must specify a project or tag if you do not specify assignee and workspace.

Parameters​

ParameterDescription
AssigneeThe 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..
Completed SinceOnly return tasks that are either incomplete or that have been completed since this time.
Modified SinceOnly return tasks that have been modified since the given time.Note: A task is considered “modified” if any of its propertieschange, or associations between it and other objects are modified(e.g. a task being added to a project). A task is not consideredmodified just because another object it is associated with (e.g. asubtask) is modified. Actions that count as modifying the taskinclude assigning, renaming, completing, and adding stories..
ProjectThe project to filter tasks on.
SectionThe section to filter tasks on.Note: Currently, this is only supported in board views..
WorkspaceThe workspace to filter tasks on.Note: If you specify workspace, you must also specify the assignee to filter on..

Example Output​

{
    "data": [
        {
            "gid": "12345",
            "name": "Bug Task",
            "resource_subtype": "default_task",
            "resource_type": "task"
        }
    ]
}

Workflow Library Example​

List Tasks with Asana and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop