Status updates

A status update is an update on the progress of a particular object, and is sent out to all followers when created. These updates include both text describing the update and a status_type intended to represent the overall state of the project. Such states include:

  • on_track for projects that are on track
  • at_risk for projects at risk
  • off_track for projects that are behind
  • on_hold for projects on hold

Status updates can be created and deleted, but not modified.


StatusUpdateCompact

A Compact object reflects the default fields returned after a successful API request. See input/output options to include more fields in the response.

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
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_subtypes for status objects represent the type of their parent.
titlestringThe title of the status update.
{
  "gid": "12345",
  "resource_type": "status_update",
  "resource_subtype": "project_status_update",
  "title": "Status Update - Jun 15"
}

StatusUpdate

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
html_textstringOpt in. The text content of the status update with formatting as HTML.
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_subtypes for status objects represent the type of their parent.
status_typestringThe type associated with the status update. This represents the current state of the object this object is on.
textstringThe text content of the status update.
titlestringThe title of the status update.
authorobjectA user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
author.gidstringGlobally unique identifier of the resource, as a string.
author.resource_typestringThe base type of this resource.
author.namestringRead-only except when same user as requester. The user’s name.
created_atstring(date-time)The time at which this resource was created.
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.
heartedbooleanDeprecated - please use liked instead. True if the status is hearted by the authorized user, false if not.
hearts[object]Deprecated - please use likes instead. Array of likes for users who have hearted this status.
» {}.gidstringGlobally unique identifier of the object, as a string.
» {}.userobjectA user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
» {}.user.gidstringGlobally unique identifier of the resource, as a string.
» {}.user.resource_typestringThe base type of this resource.
» {}.user.namestringRead-only except when same user as requester. The user’s name.
likedbooleanTrue if the status is liked by the authorized user, false if not.
likes[object]Array of likes for users who have liked this status.
» {}.gidstringGlobally unique identifier of the object, as a string.
» {}.userobjectA user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
» {}.user.gidstringGlobally unique identifier of the resource, as a string.
» {}.user.resource_typestringThe base type of this resource.
» {}.user.namestringRead-only except when same user as requester. The user’s name.
modified_atstring(date-time)The time at which this project status was last modified.
Note: This does not currently reflect any changes in associations such as comments that may have been added or removed from the status.
num_heartsintegerDeprecated - please use likes instead. The number of users who have hearted this status.
num_likesintegerThe number of users who have liked this status.
parentobjectThe parent of the status update. This can be a project, goal or portfolio, and indicates that this status was sent on that object.
parent.gidstringGlobally unique identifier of the resource, as a string.
parent.resource_typestringThe base type of this resource.
parent.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.
{
  "gid": "12345",
  "resource_type": "status_update",
  "html_text": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
  "resource_subtype": "project_status_update",
  "status_type": "on_track",
  "text": "The project is moving forward according to plan...",
  "title": "Status Update - Jun 15",
  "author": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez"
  },
  "created_at": "2012-02-22T02:06:58.147Z",
  "created_by": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez"
  },
  "hearted": true,
  "hearts": [
    {
      "gid": "12345",
      "user": {
        "gid": "12345",
        "resource_type": "user",
        "name": "Greg Sanchez"
      }
    }
  ],
  "liked": true,
  "likes": [
    {
      "gid": "12345",
      "user": {
        "gid": "12345",
        "resource_type": "user",
        "name": "Greg Sanchez"
      }
    }
  ],
  "modified_at": "2012-02-22T02:06:58.147Z",
  "num_hearts": 5,
  "num_likes": 5,
  "parent": {
    "gid": "12345",
    "resource_type": "project",
    "name": "Stuff to buy"
  }
}