Sample - Asana API
PUT/time_tracking_categories/{time_tracking_category_gid}

Update a time tracking category

Updates the properties of a time tracking category. Supply only the fields you want to change in the data object; unspecified fields remain unchanged. The response contains the complete updated time tracking category record, and the operation requires the time_tracking_categories:write scope.

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

1 parameter · 1 body field
opt_fieldsarray<string>optional
Additional time tracking category properties to include in the response, supplied as a comma-separated list. Allowed values are `color`, `is_archived`, and `name`.

The time tracking category fields to update. Provide the fields inside the data object; omitted fields remain unchanged.

dataobjectoptional
Object containing the time tracking category properties to update.

6 status codes
200Returns the complete updated time tracking category record 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 permission to update the category or lacks the required write scope.
errorsarray<object>optional
404Returned when the request does not identify a known action or the time tracking category 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 without a valid authentication token, and a 403 is returned when the authenticated user lacks permission to update the category or the time_tracking_categories:write scope. A 404 indicates that the category does not exist, while a 500 indicates a server-side failure; opt_fields values must use the documented property names.