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

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
titlestringThe title of the status update.
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. Values can be: project_status_update, portfolio_status_update, goal_status_update.

Example JSON for StatusUpdateCompact:

{
  "gid": "12345",
  "resource_type": "status_update",
  "title": "Status Update - Jun 15",
  "resource_subtype": "project_status_update"
}

StatusUpdate

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
titlestringThe title of the status update.
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. Values can be: project_status_update, portfolio_status_update, goal_status_update.
textstringThe text content of the status update.
html_textstringOpt In. The text content of the status update with formatting as HTML.
status_typestringThe type associated with the status update. This represents the current state of the object this object is on. Values can be: on_track, at_risk, off_track, on_hold, complete, achieved, partial, missed, dropped.
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.
hearts[]objectAn object to represent a user's like.
hearts[].gidstringGlobally unique identifier of the object, as a string.
hearts[].userobjectA user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
hearts[].user.gidstringGlobally unique identifier of the resource, as a string.
hearts[].user.resource_typestringThe base type of this resource.
hearts[].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.
likes[]objectAn object to represent a user's like.
likes[].gidstringGlobally unique identifier of the object, as a string.
likes[].userobjectA user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
likes[].user.gidstringGlobally unique identifier of the resource, as a string.
likes[].user.resource_typestringThe base type of this resource.
likes[].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.

Example JSON for StatusUpdate:

{
  "gid": "12345",
  "resource_type": "status_update",
  "title": "Status Update - Jun 15",
  "resource_subtype": "project_status_update",
  "text": "The project is moving forward according to plan...",
  "html_text": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
  "status_type": "example string",
  "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"
  }
}
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.