Timers

Timer is an object belonging to a Time Entry.

Timer represents one time tracking sessions (on a time entry) and keeps track when a session was started and when it was stopped.

Timer object gets created when a person starts a timer.

Creating a Timer is possible (on API) providing either time_entry_id or service_id in parameters.

  • When providing time_entry_id, a Timer object will be related to provided Time Entry.
  • When providing service_id, new Time Entry belonging to provided Service will be created and a Timer will belong to it.
ServiceTaskTime EntryTimer

You can find out more about Timers in our [Help documentation] (https://help.productive.io/en/articles/3903111-timer)

Attributes

organization organization
Response

The organization this timer belongs to.
person_id integer
Response Request Parameter `filter`

The ID of the person who owns this timer.
service_id integer
Request

The ID of the service this timer is tracking time for.
started_at string
Response Request Parameter `filter` Parameter `sort`

Timestamp when the timer was started.
stopped_at string
Response Parameter `filter` Parameter `sort`

Timestamp when the timer was stopped, or null if still running.
time_entry time entry
Response

The time entry created when this timer was stopped.
time_entry_id integer
Request Parameter `filter`

The ID of the time entry created when this timer was stopped.
total_time integer
Response

The total elapsed time of the timer in minutes.

Operations

GET /api/v2/timers
Get timers
POST /api/v2/timers
Create an timer
GET /api/v2/timers/{id}
Gets a timer
PATCH /api/v2/timers/{id}/stop
Stops a timer