Sample - Asana API
PUT/budgets/{budget_gid}

Update a budget

Replaces the supplied properties of an existing budget while preserving unspecified properties. Provide the fields to change in the data property, and use opt_fields to request optional properties in the response. A 200 response returns the updated budget.

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

1 parameter · 1 body field
opt_fieldsarray<string>optional
A comma-separated list of optional properties to include in the response, including nested properties such as `actual.value` or `estimate.units`.

The budget properties to update; fields omitted from data remain unchanged.

dataobjectoptional
The budget properties to update, including budget type, estimate, actual, total, or parent details.

7 status codes
200Returns the updated budget object with the properties selected by `opt_fields`.
dataobjectoptional
400Returned when a parameter is missing or malformed.
errorsarray<object>optional
401Returned when the request does not include a valid authentication token.
errorsarray<object>optional
402Returned when the requested budget operation exceeds the account's current premium level.
errorsarray<object>optional
403Returned when the authenticated user is not permitted to update the budget or access the requested properties.
errorsarray<object>optional
404Returned when the request does not identify a known action or the specified budget does not exist.
errorsarray<object>optional
500Returned when the API encounters a server problem; the response may include an error phrase for support diagnostics.
errorsarray<object>optional

Error handling

A 400 is returned when a parameter is missing or malformed. A 401 is returned when no valid authentication token is provided, and a 402 is returned when the requested budget operation exceeds the account's premium level. A 403, 404, or 500 is returned when access is denied, the budget or action is not found, or the API encounters a server problem; ensure data contains valid budget properties and opt_fields contains supported property names.