REST-API

The clockodo API allows you to connect clockodo to other systems. Accounting and project management applications or proprietary shell scripts are examples of useful mash-ups with clockodo.

api/v2/clock: Control the stop clock

The first version of this endpoint (api/clock) is deprecated and will not be available after Dec 31, 2022.


Get currently running entries

Response
GET /api/v2/clock
Response
{
  "running": [object of type entry]
}

Please refer to the description of the object type "entry" [object of type entry].


Start the clock

Request
POST /api/v2/clock
Required parameters customers_id, services_id
Optional parameters billable (if omitted, the default value of the customer or the project is used), projects_id, text, users_id
Response
{
  "running": [object of type entry]
}

Please refer to the description of the object type "entry" [object of type entry].


Stop the clock

Request
DELETE /api/v2/clock/[ID of the time entry]
Required parameters -
Optional parameters away, users_id
Response
{
  "stopped": [object of type entry],
  "running": [object of type entry]
}

Please refer to the description of the object type "entry" [object of type entry].


Change duration

Request
PUT /api/v2/clock/[ID of the entry to change the duration for]
Required parameters duration_before, duration
Response
{
  "updated": [object of type entry],
  "running": [object of type entry]
}

Please refer to the description of the object type "entry" [object of type entry].