Update a time tracking entry

A specific, existing time tracking entry can be updated by making a PUT request on
the URL for that time tracking entry. Only the fields provided in the data block
will be updated; any unspecified fields will remain unchanged.

When using this method, it is best to specify only those fields you wish
to change, or else you may overwrite changes made by another user since
you last retrieved the task.

Returns the complete updated time tracking entry record.

Access requirements

Access to this endpoint has two levels:

  • Endpoint access requires time tracking to be available through the domain's plan
    or add-ons. A request from a domain without time tracking access returns a
    402 Payment Required error for every request to this endpoint.

  • Field access for some request fields requires the Timesheets and Budgets add-on.
    Fields with this requirement are noted in the request schema. Including one of these
    fields without the add-on returns a 402 Payment Required error, even when the rest of
    the request is valid.

Because the field-level requirement is separate, the same endpoint may return 200 or
402 for the same domain depending on which fields are sent: a request that only uses
fields available with endpoint access succeeds on any domain that meets the endpoint
requirement, while a request that includes a field requiring the add-on also requires
the add-on.

Path Params
string
required

Globally unique identifier for the time tracking entry.

Query Params
opt_fields
array of strings

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

opt_fields
boolean

Provides “pretty” output.
Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.

Body Params

The updated fields for the time tracking entry.

data
object
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json