Time tracking

Track time on tasks with a running timer or by logging it afterwards, then pull timesheets for reporting and billing.

Three ways to record time

Method	When to use it	Body
Timer	Work is happening now. Start it, then stop it.	`billingType`, optional `notes`
Manual entry	You know how long the work took	`hours`, `minutes`, `startTime`, `billingType`
Time range	You know when the work started and ended	`startTime`, `endTime`, `billingType`

billingType is true for billable time and false for non-billable time. startTime and endTime are epoch milliseconds.

Start the timer

The response contains a trackId. Keep it to stop the timer.

Stop the timer

The billingType and notes you send here are saved on the entry.

Get active timers for a user lists timers that are still running.

You can change and delete only your own entries.

Update a timer needs timerData.startTime. To change the length, send hours and minutes as well.

WARNING

Send billingType on every update. If you leave it out, the entry becomes non-billable.

Report	What it returns
Get global timesheet report	Time across the workspace between `startDate` and `endDate` (`yyyy-MM-dd`), grouped by `PROJECT` or `MEMBER`
Get project timesheet	Every entry in one project, grouped by person
Get project timesheet summary	Billable, non-billable and total time for one project, in milliseconds
Get timers for a user in a task	One person's entries on one task

Action	Project task	Personal task
Start a timer	Start timer for a project task	Start timer for a personal task
Stop a timer	Stop timer for a task	Same endpoint
Log manual time	Add manual time entry for a project task	Add manual time entry for a personal task
Log a time range	Add range timer for a project task	Add a time range entry for a personal task
Update an entry	Update a timer	Same endpoint
Delete an entry	Delete a timer entry	Same endpoint