Time tracking entries

Asana’s native time tracking feature allows you to estimate the time needed to complete a task, as well as record the actual time spent.


TimeTrackingEntry

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
duration_minutesintegerTime in minutes tracked by the entry.
entered_onstring (date)The day that this entry is logged on.
attributable_toobjectThe attributable to project specifies which project's budget a time entry should be counted toward, if the task belongs to more than one project. If it only belongs to one project, it should be that project.
attributable_to.gidstringGlobally unique identifier of the resource, as a string.
attributable_to.resource_typestringThe base type of this resource.
attributable_to.namestringName of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
created_byobjectA user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
created_by.gidstringGlobally unique identifier of the resource, as a string.
created_by.resource_typestringThe base type of this resource.
created_by.namestringRead-only except when same user as requester. The user's name.
categories[][object]The categories linked to this time tracking entry.
categories[].gidstringGlobally unique identifier of the resource, as a string.
categories[].resource_typestringThe base type of this resource.
categories[].namestringThe name of the time tracking category.
categories[].colorstringThe color associated with this category for display purposes.
Click to show all enum values
  • aqua
  • blue
  • blue-green
  • cool-gray
  • green
  • hot-pink
  • indigo
  • magenta
  • none
  • orange
  • pink
  • purple
  • red
  • yellow
  • yellow-green
  • yellow-orange
taskobject

Full object requires scope:tasks:read

The task is the basic object around which many operations in Asana are centered.
task.gidstringGlobally unique identifier of the resource, as a string.
task.resource_typestringThe base type of this resource.
task.namestringThe name of the task.
task.resource_subtypestringThe subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning. The resource_subtype milestone represent a single moment in time. This means tasks with this subtype cannot have a start_date.
Click to show all enum values
  • approval
  • custom
  • default_task
  • milestone
task.created_byobjectOpt In. A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
task.created_by.gidstringGlobally unique identifier of the resource.
task.created_by.resource_typestringThe type of resource.
created_atstring (date-time)The time at which this resource was created.
approval_statusstringOptional. The current approval status of the entry.
Click to show all enum values
  • APPROVED
  • DRAFT
  • REJECTED
  • SUBMITTED
billable_statusstringOptional. The current billable status of the entry.
Click to show all enum values
  • billable
  • nonBillable
  • notApplicable
descriptionstringOptional. The description of the entry.

Example JSON for TimeTrackingEntry:

{
  "gid": "12345",
  "resource_type": "time_tracking_entry",
  "duration_minutes": 12,
  "entered_on": "2015-03-14",
  "attributable_to": {
    "gid": "12345",
    "resource_type": "project",
    "name": "Stuff to buy"
  },
  "created_by": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez"
  },
  "categories": [
    {
      "gid": "12345",
      "resource_type": "time_tracking_category",
      "name": "Development",
      "color": "blue"
    }
  ],
  "task": {
    "gid": "12345",
    "resource_type": "task",
    "name": "Bug Task",
    "resource_subtype": "default_task",
    "created_by": {
      "gid": "1111",
      "resource_type": "user"
    }
  },
  "created_at": "2012-02-22T02:06:58.147Z",
  "approval_status": "DRAFT",
  "billable_status": "billable",
  "description": "My description of work done on this entry"
}