CLclickup
Time Tracking

Update a time Entry

Changed on

Update the details of a time entry.

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

Request

  • Base URL
    https://api.clickup.com/api
  • URL
    https://api.clickup.com/api/v2/team/{team_id}/time_entries/{timer_id}
  • Auth
    API key in header Authorization

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

  • a0a72ec97ddbRevision changes
    • breaking

      added the new required request property //

    • breaking

      added the new required request property //

    • breaking

      added the new required request property //

    • breaking

      the / request property type changed from no type to object