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 trackat_risk
for projects at riskoff_track
for projects that are behindon_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"
}
}