Asana · Schema

Asana Task

The task is the basic object around which many operations in Asana are centered. Tasks represent units of work that can be assigned, prioritized, and tracked.

CollaborationProductivityProject ManagementProjectsTask ManagementTasksWorkflow

Properties

Name Type Description
gid string Globally unique identifier of the resource, as a string.
resource_type string The base type of this resource.
resource_subtype string The subtype of this resource.
name string Name of the task. Generally a short sentence fragment.
approval_status string Conditional. Reflects the approval status of this task.
completed boolean True if the task is currently marked complete.
completed_at stringnull The time at which this task was completed, or null if incomplete.
completed_by object The user who completed this task.
created_at string The time at which this resource was created.
modified_at string The time at which this task was last modified.
due_at stringnull The UTC date and time on which this task is due.
due_on stringnull The localized date on which this task is due (YYYY-MM-DD).
start_at stringnull Date and time on which work begins for the task.
start_on stringnull The day on which work begins for the task (YYYY-MM-DD).
notes string Free-form textual information associated with the task.
html_notes string The notes of the text with formatting as HTML.
assignee object The user to whom this task is assigned.
parent object The parent of this task, or null if not a subtask.
projects array Array of projects this task is associated with.
tags array Array of tags associated with this task.
followers array Array of users following this task.
workspace object The workspace this task is associated with.
custom_fields array Array of custom field values applied to the task.
liked boolean True if the task is liked by the authorized user.
num_likes integer The number of users who have liked this task.
num_subtasks integer The number of subtasks on this task.
permalink_url string A URL that points directly to the object within Asana.
actual_time_minutes numbernull Sum of all Time Tracking entries in the Actual Time field.
external object OAuth Required. App-specific metadata on tasks.
memberships array Array of projects and sections this task belongs to.
View JSON Schema on GitHub