Sample - Asana API
PUT/projects/{project_gid}

Update a project

Updates an existing project using only the fields supplied in the data block. Provide the project identifier and send only the properties you want to change to avoid overwriting changes made by another user; updating team is deprecated in favor of project memberships. A 200 response returns the complete updated project 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 updated project response, such as `archived`, `completed`, `created_at`, or `current_status`; nested fields such as `current_status.author.name` are supported.

The project fields to update in the data block; unspecified fields remain unchanged.

dataobjectoptional
The project properties to change.

6 status codes
200Returns the complete updated project 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 permission to update the project or its 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 project from being updated.
errorsarray<object>optional

Error handling

A 400 is returned when a parameter or request field is missing or malformed. A 401 is returned when you do not provide a valid authentication token, and a 403 is returned when the authenticated user cannot update 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.