Project statuses

❗️

Deprecated

New integrations should prefer using status updates.

A project status is an update on the progress of a particular project, and is sent out to all project followers when created. These updates include both text describing the update and a color code intended to represent the overall state of the project: "green" for projects that are on track, "yellow" for projects at risk, "red" for projects that are behind, and "blue" for projects on hold.

Project statuses can be created and deleted, but not modified.


ProjectStatusCompact

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
titlestringThe title of the project status update.

Example JSON for ProjectStatusCompact:

{
  "gid": "12345",
  "resource_type": "project_status",
  "title": "Status Update - Jun 15"
}

ProjectStatus

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
titlestringThe title of the project status update.
textstringThe text content of the status update.
html_textstringOpt In. The text content of the status update with formatting as HTML.
colorstringThe color associated with the status update. Values can be: green, yellow, red, blue, complete.
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.
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 project status.

Example JSON for ProjectStatus:

{
  "gid": "12345",
  "resource_type": "project_status",
  "title": "Status Update - Jun 15",
  "text": "The project is moving forward according to plan...",
  "html_text": "<body>The project <strong>is</strong> moving forward according to plan...</body>",
  "color": "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"
  },
  "modified_at": "2012-02-22T02:06:58.147Z"
}
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.