Update an entry's description, project or times

Rewrites the description, project, start time and/or end time of one of your entries — running or finished. Made for the "timer started, described later" flow (no need to stop or restart anything) and for correcting times after the fact, e.g. a timer left running long after the work ended. Setting ended_at on a running entry finishes it at that moment instead of now. Entries already billed on an invoice are frozen and return 409. Requires the entries:write scope.

patch/api/v1/entries/{entry}

Request

  • Base URL: https://tallymeter.com
  • URL: https://tallymeter.com/api/v1/entries/{entry}
  • Auth: HTTP bearer

Path parameters

entryinteger required

Entry id, e.g. from the timer endpoints.

Request body

descriptionstring

New description. Omit to keep the current one; cannot be cleared over the API.

project_idinteger nullable

New project id from GET /api/v1/projects; null detaches the entry from any project. Omit to keep the current project.

started_atstring date-time

New ISO-8601 start time (UTC unless an offset is given). Omit to keep the current start.

ended_atstring date-time

New ISO-8601 end time; on a running entry this finishes it at that moment. Must be after the start, and neither time may be in the future. Omit to leave the end as it is.

Example request

{
  "description": "ABC-1 fix login",
  "started_at": "2026-08-08T14:45:00Z",
  "ended_at": "2026-08-08T15:58:27Z"
}

Response

Entry updated

updatedtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.