My work

update-worklog-tool

Update fields on an existing time entry.

Updates one worklog and returns it in the same shape as list-worklogs-tool. Only the fields you include are changed; others are left intact.

Inputs

NameTypeRequiredDescription
idintegeryesWorklog id.
datestring (Y-m-d)no
minutesintegerno1–1440.
descriptionstringnoUp to 5000 characters.
project_idintegerno
deadline_idinteger|nullnoPass null to detach the deadline.
work_item_idinteger|nullno
is_overtimebooleannoSilently coerced to false if the user lacks times::write_overtime.
is_not_billablebooleannoWhen changing deadline_id without setting this, the value is inferred from the new deadline.
reasonstring|nullno

Permissions

  • Editing your own worklog: always allowed.
  • Editing another user's worklog: times::update_others.
  • is_overtime: true: requires times::write_overtime (otherwise silently coerced to false).
  • Re-pointing deadline_id to a deadline owned by another user: times::write_on_others_deadlines.

Example

{
  "id": 42,
  "minutes": 120,
  "description": "Refactor payment gateway + retries"
}

Response

The updated worklog, in the same shape as a row from list-worklogs-tool.

Errors

  • Editing a worklog you don't own without times::update_others returns an authorization error.
  • Passing a deadline_id that doesn't belong to the worklog's project returns a 404-style error.
  • Missing id returns a validation error.

On this page