Time Entries API
PATCH/api/v1/stopwatch/{id}
Product availabilityAlgaPSA

Update stopwatch draft

Updates the notes and/or service of an open session. Omitted fields are unchanged; `service_id: null` clears the service.

RBAC · time_entry

Path parameters

idstring <uuid>Required
UUID path identifier from underlying resource tables.

Request body

Content type: application/json · schema WorkV1StopwatchUpdateBody

notesstring
service_idstring <uuid>Nullable

Response body

Success response 200 · schema WorkV1StopwatchSessionResponse

dataobjectRequired
session_idstring <uuid>Required
user_idstring <uuid>Required
work_item_typestringRequired
work_item_idstring <uuid>RequiredNullable
service_idstring <uuid>RequiredNullable
notesstringRequired
statusstringRequired
Enum: runningpausedloggeddiscarded
time_entry_idstring <uuid>RequiredNullable
closed_atstring <date-time>RequiredNullable
created_atstring <date-time>Required
updated_atstring <date-time>Required
segmentsarray of objectRequired
itemsobject
segment_idstring <uuid>Required
started_atstring <date-time>Required
ended_atstring <date-time>RequiredNullable
Null while the segment is open (the stopwatch is running).
active_msnumberRequired
Active (non-paused) milliseconds as of server_now.
server_nowstring <date-time>Required
Server clock at the moment the response was built; derive a clock offset from it.
ticket_numberstringRequiredNullable
work_item_titlestringRequiredNullable
project_namestringRequiredNullable
client_namestringRequiredNullable
service_namestringRequiredNullable

Response codes

200
Updated session.
400
Validation failure.
401
API key missing/invalid or associated user missing.
403
Permission denied (time_entry:create for mutations, time_entry:read for reads).
404
Stopwatch session not found (or it belongs to another user).
409
The session is already logged or discarded (details.reason is the message key).
500
Unexpected failure.