Sample - Asana API
PUT/time_tracking_entries/{time_tracking_entry_gid}

Update a time tracking entry

Updates an existing time tracking entry. Send only the fields you want to change in the data object so that unspecified values remain unchanged. Fields requiring the Timesheets and Budgets add-on return a premium-access error when that add-on is unavailable.

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

1 parameter · 1 body field
opt_fieldsarray<string>optional
A comma-separated list of properties to include in the response, including nested properties; accepted values include `approval_status`, `attributable_to`, `attributable_to.name`, `attributable_to.resource_subtype`, `billable_status`, `categories`, `categories.color`, `categories.name`, `created_at`, `created_by`, `created_by.name`, and `description`. Omit this parameter to use the default response fields.

The fields to update on the time tracking entry; unspecified fields remain unchanged.

dataobjectoptional
Object containing the time tracking entry fields to update.

7 status codes
200Returns the complete updated time tracking entry record.
dataobjectoptional
400Returned when a parameter or request value is missing or malformed.
errorsarray<object>optional
401Returned when a valid authentication token was not provided with the request.
errorsarray<object>optional
402Returned when time tracking is unavailable through the domain's plan or add-ons, or when a submitted field requires the Timesheets and Budgets add-on that the domain does not have.
errorsarray<object>optional
403Returned when the authenticated user does not have access to the requested objects or properties.
errorsarray<object>optional
404Returned when the request method and path do not specify a known action, or the specified object does not exist.
errorsarray<object>optional
500Returned when a server-side problem occurs; the response may include an error phrase for support diagnosis.
errorsarray<object>optional

Error handling

A 400 is returned when a parameter or request value is missing or malformed. A 401 is returned when a valid authentication token is not provided, a 402 is returned when time tracking or a submitted premium field is unavailable on the domain's plan, and a 403 is returned when the authenticated user lacks access. A 404 is returned when the time tracking entry or specified object does not exist, while a 500 indicates a server-side problem. billable_status must be one of billable, nonBillable, or notApplicable, and categories can contain at most one category.