Sample - Asana API
POST/projects/{project_gid}/project_statuses

Create a project status

Creates a new status update for a specific project. Supply the project status in the data block and include color; use the /status_updates route for new integrations. A 201 response returns the complete created project status record.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 1 body field
opt_fieldsarray<string>optional
Comma-separated fields to include in the response, such as `author`, `color`, `created_at`, `text`, or `title`; nested fields such as `author.name` are supported.

The project status to create in the data block; color is required.

dataobjectoptional
The project status details, including the required `color` field.

6 status codes
201Returns the newly created project status object.
dataobjectoptional
400Returned when a parameter or request field is missing or malformed.
errorsarray<object>optional
401Returned when a valid authentication token was not provided with the request.
errorsarray<object>optional
403Returned when the authenticated user does not have access to the project or requested properties.
errorsarray<object>optional
404Returned when the request action is not recognized or the specified project does not exist.
errorsarray<object>optional
500Returned when a server-side problem prevents the request from completing.
errorsarray<object>optional

Error handling

A 400 is returned when a parameter or request field is missing or malformed, including when color is omitted. A 401 is returned when you do not provide a valid authentication token, and a 403 is returned when the authenticated user cannot access the project. A 404 is returned when the project does not exist or the action is not recognized; a 500 indicates a server-side failure.