Sample - Asana API
PUT/teams/{team_gid}

Update a team

Updates a team within the current workspace. Supply the fields you want to change in the data object, while omitted fields retain their existing values. Use opt_fields to request additional nested properties in the updated team response.

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

1 parameter · 1 body field
opt_fieldsarray<string>optional
Additional team properties to include in the response, supplied as a comma-separated list; values can include nested fields such as `custom_field_settings.custom_field.name`. Allowed values are the documented team property names.

The team fields to update. Provide the fields inside the data object; omitted fields remain unchanged.

dataobjectoptional
Object containing the team properties to update.

6 status codes
200Returns the updated team resource in the `data` property.
dataobjectoptional
400Returned when a request parameter or body value is missing or malformed.
errorsarray<object>optional
401Returned when a valid authentication token was not provided.
errorsarray<object>optional
403Returned when the authenticated user does not have access to update the team or its properties.
errorsarray<object>optional
404Returned when the request does not identify a known action or the team does not exist.
errorsarray<object>optional
500Returned when a server-side problem prevents the update from completing.
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 modify the team. A 404 indicates that the team does not exist, while a 500 indicates a server-side failure; opt_fields values must be selected from the documented property names.