v1

latestOpenAPI 3.1.02026-07-14801408.6 KB

/time-tracking/employees/:id/time-entries/:uuid

Updates an existing time entry. At least one of clock_in_time, clock_out_time, or note must be provided. Supports both user and account tokens. Required scope: w_time_tracking.

patch/time-tracking/employees/{key}/time-entries/{uuid}

Path parameters

keystring required

SPI key of the employee

uuidstring required

UUID of the time entry

Request body

clock_in_timestring

Updated ISO 8601 clock-in timestamp with timezone designator (UTC Z or numeric offset). Stored in UTC. Seconds and milliseconds are truncated to the start of the minute.

clock_out_timestring

Updated ISO 8601 clock-out timestamp with timezone designator (UTC Z or numeric offset). Stored in UTC. Seconds and milliseconds are truncated to the start of the minute.

notestring nullable

Updated note. Pass null to clear.

override_overlappingboolean

When true, archives any overlapping time entries.

Response

  1. Returns the updated entry with its current fields. Time strings are in UTC (with Z suffix).
typestring
uuidstring
clock_in_timestring nullable

Clock-in time in UTC (with Z suffix)

clock_out_timestring nullable

Clock-out time in UTC (with Z suffix)

notestring nullable

Example response

{
  "type": "clock-out",
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "clock_in_time": "2024-09-27T10:00:00.000Z",
  "clock_out_time": "2024-09-27T18:00:00.000Z"
}