Sample - Asana API
POST/status_updates

Create a status update

Creates a new status update for an object. Supply the parent object in parent and optionally use opt_fields to request additional response properties. A 201 response returns the complete newly created status update record.

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

1 parameter · 1 body field
opt_fieldsarray<string>optional
Comma-separated list of optional status update fields to include in the response, such as `author`, `created_at`, `html_text`, `likes`, or `hearts`; nested fields such as `author.name` are supported.

The status update to create, including the object that receives it.

dataobjectoptional

6 status codes
201Returns the newly created status update object with its available resource fields.
dataobjectoptional
400Returned when the request is missing `parent` or contains a malformed parameter.
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 parent object or status update operation.
errorsarray<object>optional
404Returned when the specified parent object does not exist.
errorsarray<object>optional
500Returned when a server-side problem prevents the status update from being created.
errorsarray<object>optional

Error handling

A 400 is returned when the request is missing or malformed. A 401 is returned when no valid authentication token is provided, and a 403 is returned when the authenticated user lacks access to the parent object. A 404 is returned when the parent object does not exist, while a 500 indicates a server-side failure; parent must identify the object that receives the status update.