Time Entries API
GET/api/v1/stopwatch/active
Product availabilityAlgaPSA

Get active stopwatch session

Returns the caller's open (running or paused) stopwatch session, or `data: null`. Elapsed time is derived from `segments`; `active_ms` and `server_now` are computed by the server. `user_id` reads another user's session and requires delegation rights (time_sheet:approve plus read_all or manager-of-subject).

RBAC · time_entry

Query parameters

user_idstring <uuid>Optional

Response body

Success response 200 · schema WorkV1StopwatchActiveResponse

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
Open session or null.
400
Invalid query.
401
API key missing/invalid or associated user missing.
403
Permission denied (time_entry:create for mutations, time_entry:read for reads).
500
Unexpected failure.