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 object.

The valid values for status_type depend on the parent of the status update:

Projects: on_track, at_risk, off_track, on_hold, complete, dropped.
Portfolios: on_track, at_risk, off_track, on_hold, complete, dropped.
Goals: on_track, at_risk, off_track, achieved, partial, missed, dropped.

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. Click to show all enum values `goal_status_update` `portfolio_status_update` `project_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. Click to show all enum values `goal_status_update` `portfolio_status_update` `project_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. The valid values for `status_type` depend on the parent of the status update: - Projects: `on_track`, `at_risk`, `off_track`, `on_hold`, `complete`, `dropped`. - Portfolios: `on_track`, `at_risk`, `off_track`, `on_hold`, `complete`, `dropped`. - Goals: `on_track`, `at_risk`, `off_track`, `achieved`, `partial`, `missed`, `dropped`. Click to show all enum values `achieved` `at_risk` `complete` `dropped` `missed` `off_track` `on_hold` `on_track` `partial`
`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[].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[].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.
`reaction_summary[]`	[object]	Summary of emoji reactions on this status.
`reaction_summary[].emoji_base`	string	The emoji base character used in the reaction.
`reaction_summary[].variant`	string	The full emoji string used in the reaction.
`reaction_summary[].count`	number	The number of reactions with the emoji variant on the object.
`reaction_summary[].reacted`	boolean	Whether the current user has reacted with the emoji variant on the object.
`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.
`parent.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. Click to show all enum values `custom` `default_project`

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"
      }
    }
  ],
  "reaction_summary": [
    {
      "emoji_base": "👎",
      "variant": "👎🏼",
      "count": 1,
      "reacted": false
    }
  ],
  "modified_at": "2012-02-22T02:06:58.147Z",
  "num_hearts": 5,
  "num_likes": 5,
  "parent": {
    "gid": "12345",
    "resource_type": "project",
    "name": "Stuff to buy",
    "resource_subtype": "default_project"
  }
}