v1

latestOpenAPI 3.0.02026-08-061478520.6 KB

[v3] Time Entry

Update time entry

Update a time entry by id.

put/v3/time-entries/{id}

Path parameters

idinteger required

Example:123

Time entry id.

Headers

Acceptstring

Example:application/json

Tc-servicestring

Example:tc_web

Optional service name used for activity and analytics context.

Request body

datestring date

startTimestring

endTimestring

durationinteger

Duration in seconds.

increaseboolean

When true, adds duration to the current time entry duration instead of replacing it.

notestring

Time entry note. Takes precedence over description when both are provided.

descriptionstring

Time entry description. Used when note is not provided.

billableboolean

invoiceIdinteger

taskIdinteger

analyticsPlacestring

analyticsElementstring

Example request

{
  "date": "2026-06-18",
  "startTime": "09:00:00",
  "endTime": "10:00:00",
  "duration": 3600,
  "note": "Updated work note",
  "description": "Updated work note",
  "billable": true,
  "invoiceId": 44,
  "taskId": 123,
  "analyticsPlace": "report_detailed",
  "analyticsElement": "duration"
}

Response

Time entry updated successfully.

Example response

{
  "data": {
    "entry_id": 123,
    "task_id": 456,
    "time_span": 3600,
    "user_id": 789,
    "date": "2026-06-18",
    "start_time_hour": "09:00:00",
    "end_time_hour": "10:00:00",
    "note": "Updated work note",
    "billable": true,
    "invoiceId": 44,
    "color": "#4DC2E8",
    "tags": [
      7
    ]
  },
  "meta": {
    "tags": [
      {
        "id": 7,
        "name": "My tag"
      }
    ]
  }
}