Create a project status

Deprecated: new integrations should prefer the /status_updates route.

Creates a new status update on the project.

Returns the full record of the newly created project status update.

Path Params
string
required

Globally unique identifier for the project.

Query Params
array of strings

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

opt_fields
boolean

Provides “pretty” output.
Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.

Body Params

The project status to create.

object

Deprecated: new integrations should prefer the status_update resource.
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, and "red" for projects that are behind.

Responses

Response body
object
object

Deprecated: new integrations should prefer the status_update resource.
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, and "red" for projects that are behind.

string

Globally unique identifier of the resource, as a string.

string

The base type of this resource.

string

The title of the project status update.

string

The text content of the status update.

string

Opt In. The text content of the status update with formatting as HTML.

string

The color associated with the status update.

green yellow red blue complete

object

A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.

date-time

The time at which this resource was created.

object

A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.

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.

Language
Credentials
Request
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.