Sign in
Time Tracking

Update a time Entry

Update the details of a time entry.

put/v2/team/{team_id}/time_entries/{timer_id}

Path parameters

team_idnumber required
Example:123

Workspace ID

timer_idnumber required
Example:2004673344540003600

Query parameters

custom_task_idsboolean
Example:true

If you want to reference a task by it's custom task id, this value must be true.

team_idnumber
Example:123

When the custom_task_ids parameter is set to true, the Workspace ID must be provided using the team_id parameter.
For example: custom_task_ids=true&team_id=123

Request body

descriptionstring
tagsItems[] required— unresolved $ref

Unlimited uses of time entry tags are available on the Business Plus and Enterprise Plan.

tag_actionstring

Tag actions are replace, add, and remove. You can perform one tag action per request.

startinteger

When providing start, you must also provide end.

endinteger

When providing end, you must also provide start.

tidstring

You can provide a task ID to associate the time entry with a task. Unlimited uses of time entries that are not associated with tasks are available on the Business Plus and Enterprise Plan.

billableboolean
durationinteger

Example request

{
  "description": "",
  "tags": [
    {
      "name": "name of tag",
      "tag_bg": "#BF55EC",
      "tag_fg": "#FFFFFF"
    }
  ],
  "tag_action": "add",
  "start": 1595289395842,
  "end": 1595289495842,
  "tid": "task_id",
  "billable": true,
  "duration": 100000
}

Response

object required

Changes