Asana API

Getting access, Developing, Testing

Back to Asana

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.

Input

type: object properties: parameters: type: object properties: project_gid: type: string description: Globally unique identifier for the project. opt_pretty: type: boolean description: >- 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. opt_fields: type: array items: type: string description: >- Defines fields to return. Some requests return *compact* representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options. required: - project_gid title: Parameters data: type: object properties: data: type: object properties: gid: description: Globally unique identifier of the resource, as a string. type: string readOnly: true example: '12345' x-insert-after: false resource_type: description: The base type of this resource. type: string readOnly: true example: task x-insert-after: gid title: description: The title of the project status update. type: string example: Status Update - Jun 15 text: description: The text content of the status update. type: string example: The project is moving forward according to plan... html_text: description: >- [Opt In](/docs/inputoutput-options). The text content of the status update with formatting as HTML. type: string example: >- <body>The project <strong>is</strong> moving forward according to plan...</body> color: description: The color associated with the status update. type: string enum: - green - yellow - red - blue title: Data

Output

type: object properties: data: type: object properties: gid: description: Globally unique identifier of the resource, as a string. type: string readOnly: true example: '12345' x-insert-after: false resource_type: description: The base type of this resource. type: string readOnly: true example: task x-insert-after: gid title: description: The title of the project status update. type: string example: Status Update - Jun 15 text: description: The text content of the status update. type: string example: The project is moving forward according to plan... html_text: description: >- [Opt In](/docs/inputoutput-options). The text content of the status update with formatting as HTML. type: string example: >- <body>The project <strong>is</strong> moving forward according to plan...</body> color: description: The color associated with the status update. type: string enum: - green - yellow - red - blue author: type: object properties: gid: description: Globally unique identifier of the resource, as a string. type: string readOnly: true example: '12345' x-insert-after: false resource_type: description: The base type of this resource. type: string readOnly: true example: task x-insert-after: gid name: type: string description: '*Read-only except when same user as requester*. The user’s name.' example: Greg Sanchez created_at: description: The time at which this resource was created. type: string format: date-time readOnly: true example: '2012-02-22T02:06:58.147Z' created_by: type: object properties: gid: description: Globally unique identifier of the resource, as a string. type: string readOnly: true example: '12345' x-insert-after: false resource_type: description: The base type of this resource. type: string readOnly: true example: task x-insert-after: gid name: type: string description: '*Read-only except when same user as requester*. The user’s name.' example: Greg Sanchez modified_at: description: >- 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.* type: string format: date-time readOnly: true example: '2012-02-22T02:06:58.147Z'