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

Property	Type	Description
`gid`	string	Globally unique identifier of the resource, as a string.
`resource_type`	string	The base type of this resource.
`title`	string	The title of the status update.
`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. 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

Property	Type	Description
`gid`	string	Globally unique identifier of the resource, as a string.
`resource_type`	string	The base type of this resource.
`title`	string	The title of the status update.
`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. Values can be: `project_status_update`, `portfolio_status_update`, `goal_status_update`.
`text`	string	The text content of the status update.
`html_text`	string	Opt In. The text content of the status update with formatting as HTML.
`status_type`	string	The 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`.
`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.
`hearts[]`	object	An object to represent a user's like.
`hearts[].gid`	string	Globally unique identifier of the object, as a string.
`hearts[].user`	object	A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
`hearts[].user.gid`	string	Globally unique identifier of the resource, as a string.
`hearts[].user.resource_type`	string	The base type of this resource.
`hearts[].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.
`likes[]`	object	An object to represent a user's like.
`likes[].gid`	string	Globally unique identifier of the object, as a string.
`likes[].user`	object	A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
`likes[].user.gid`	string	Globally unique identifier of the resource, as a string.
`likes[].user.resource_type`	string	The base type of this resource.
`likes[].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.

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"
  }
}