Sample - Asana API
PUT/portfolios/{portfolio_gid}

Update a portfolio

Updates an existing portfolio with the fields supplied in the request. Use the data body property to provide only the portfolio fields you want to change; unspecified fields remain unchanged. Use opt_fields to request additional properties in the complete updated portfolio response.

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

1 parameter · 1 body field
opt_fieldsarray<string>optional
Comma-separated list of optional response properties to include, including nested properties such as `created_by.name` and `custom_field_settings.custom_field`; omit it to use the default response fields.

The portfolio fields to update.

dataobjectoptional
Object containing the portfolio properties to change, including custom fields and custom type information where applicable.

6 status codes
200Returns the complete updated portfolio record.
dataobjectoptional
400Returned when a parameter is missing or malformed.
errorsarray<object>optional
401Returned when a valid authentication token is not provided.
errorsarray<object>optional
403Returned when the authenticated user does not have access to the requested operation or properties.
errorsarray<object>optional
404Returned when the request does not specify a known action or the referenced object does not exist.
errorsarray<object>optional
500Returned when a server-side problem occurs; the response may include an error phrase.
errorsarray<object>optional

Error handling

A 400 is returned when a parameter is missing or malformed. A 401 is returned when the request does not include a valid authentication token; a 403 is returned when the authenticated user cannot access the requested portfolio operation; and a 404 is returned when the request does not identify a known action or object. A 500 is returned when a server-side problem occurs. Send the fields to update in data and use opt_fields only with supported property names.