Sample - Asana API
PUT/allocations/{allocation_gid}

Update an allocation

Updates an existing allocation using the fields supplied in the data request body. Omitted fields remain unchanged, and you can use opt_fields to include optional properties in the returned allocation. The response contains the complete updated allocation record.

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

1 parameter · 1 body field
opt_fieldsarray<string>optional
A comma-separated list of optional allocation properties to include in the response, including supported nested properties such as `assignee.name` and `parent.name`. Defaults to the endpoint's default property set when omitted.

The allocation fields to update. Include only the properties that should change; omitted properties remain unchanged.

dataobjectoptional
The allocation fields to update, such as `assignee`, `parent`, `start_date`, `end_date`, and `effort`. Only the fields provided in this object are changed.

6 status codes
200Returns the complete updated allocation record, including the fields selected through `opt_fields`.
dataobjectoptional
400Returned when a parameter or request body value 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 access to update the allocation.
errorsarray<object>optional
404Returned when the request method and path do not specify a known action or the allocation does not exist.
errorsarray<object>optional
500Returned when a server-side problem prevents the API from completing the update.
errorsarray<object>optional

Error handling

A 400 is returned when data or a parameter is missing or malformed. A 401 is returned when a valid authentication token is not provided, and a 403 is returned when the authenticated user cannot update the allocation. A 404 is returned when the allocation or action does not exist, while a 500 indicates a server-side problem. opt_fields accepts a comma-separated selection of supported properties, including nested fields such as assignee.name and parent.name.