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/projects: Manage projects


Object type „project“

Parameter Type Description
id integer ID of the project
customers_id integer ID of the corresponding customer
name string Name of the project
active boolean Is the project active?
billable_default boolean Is the project billable by default? (1 or 0)
note string Note for the project
budget_money float Budget for the project
budget_is_hours boolean Is the budget based on hours?
budget_is_not_strict boolean Is the budget not strict?

List projects

Please use /api/customers. There, customers an projects will be listet nested.


Get project

Request
GET /api/projects/[ID]
Response
{
  "project": [object of type project]
}

Add projects

Request
POST /api/projects
Required parameters name, customers_id
Optional parameters active, billable_default, budget_money, budget_is_hours, budget_is_not_strict, note
Response
{
  "project": [object of type project]
}

Edit projects

Request
PUT /api/projects/[ID]
Required parameters none
Optional parameters name, active, billable_default, budget_money, budget_is_hours, budget_ist_not_strict, note, hourly_rate, customers_id
Response
{
  "project": [object of type project]
}

Deactivate projects

Request
DELETE /api/projects/[ID]
Response
{
  "project": [object of type project]
}