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/holidaysquota: Manage holiday quotas


Object type „holidaysquotaRow“

Parameter Type Description
id integer The ID of the holiday quota settings
users_id integer The related employee's ID
year_since integer Year from which on the holiday quota setting apply Format YYYY
year_until integer|null Year until which the holiday quota setting apply Format YYYY
count float (only full and half values allowed) Count of holidays

List holiday quotas

Request
GET /api/holidaysquota
Optional parameter users_id (integer) Restrict data to this user
Response
{
  "holidaysquota": 
  {
    [object of type holidaysquotaRow],
    [object of type holidaysquotaRow], 
    ...
  }
}

Request single holiday quota

Request
GET /api/holidaysquota/[ID]
Response
{
  "holidaysquotaRow": [object of type holidaysquotaRow]
}

Add holiday quota

POST /api/holidaysquota
Required parameters users_id, year_since, count
Optional parameters year_until
Response
{
  "holidaysquotaRow": [object of type holidaysquotaRow]
}

Edit holiday quota

PUT /api/holidaysquota/[ID]
Optional parameters year_since, year_until, count
Response
{
  "holidaysquotaRow": [object of type holidaysquotaRow]
}

Delete holiday quota

DELETE /api/holidaysquota/[ID]
Response
{
  "success": true
}