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.

Property	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. 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`s for `status` objects represent the type of their parent.
`title`	string	The title of the status update.

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

StatusUpdate

Property	Type	Description
`gid`	string	Globally unique identifier of the resource, as a string.
`resource_type`	string	The base type of this resource.
`html_text`	string	Opt in. The text content of the status update with formatting as HTML.
`resource_subtype`	string	The 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_type`	string	The type associated with the status update. This represents the current state of the object this object is on.
`text`	string	The text content of the status update.
`title`	string	The title of the status update.
`author`	object	A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
`author`.`gid`	string	Globally unique identifier of the resource, as a string.
`author`.`resource_type`	string	The base type of this resource.
`author`.`name`	string	Read-only except when same user as requester. The user’s name.
`created_at`	string(date-time)	The time at which this resource was created.
`created_by`	object	A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
`created_by`.`gid`	string	Globally unique identifier of the resource, as a string.
`created_by`.`resource_type`	string	The base type of this resource.
`created_by`.`name`	string	Read-only except when same user as requester. The user’s name.
`hearted`	boolean	Deprecated - 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.
» `{}`.`gid`	string	Globally unique identifier of the object, as a string.
» `{}`.`user`	object	A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
» `{}`.`user`.`gid`	string	Globally unique identifier of the resource, as a string.
» `{}`.`user`.`resource_type`	string	The base type of this resource.
» `{}`.`user`.`name`	string	Read-only except when same user as requester. The user’s name.
`liked`	boolean	True if the status is liked by the authorized user, false if not.
`likes`	[object]	Array of likes for users who have liked this status.
» `{}`.`gid`	string	Globally unique identifier of the object, as a string.
» `{}`.`user`	object	A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
» `{}`.`user`.`gid`	string	Globally unique identifier of the resource, as a string.
» `{}`.`user`.`resource_type`	string	The base type of this resource.
» `{}`.`user`.`name`	string	Read-only except when same user as requester. The user’s name.
`modified_at`	string(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_hearts`	integer	Deprecated - please use `likes` instead. The number of users who have hearted this status.
`num_likes`	integer	The number of users who have liked this status.
`parent`	object	The parent of the status update. This can be a project, goal or portfolio, and indicates that this status was sent on that object.
`parent`.`gid`	string	Globally unique identifier of the resource, as a string.
`parent`.`resource_type`	string	The base type of this resource.
`parent`.`name`	string	Name 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"
  }
}