API Documentation
Overview
Time Tracking
Extended REST API
Clients
Client Contacts
Projects
Tasks
People
Expenses
Expense Tracking
User Assignment
Task Assignment
Reports
Invoices
Invoice Messages
Invoice Payments
Invoice Categories
Questions? Contact support
Overview
Time Tracking
Extended REST API
Clients
Client Contacts
Projects
Tasks
People
Expenses
Expense Tracking
User Assignment
Task Assignment
Reports
Invoices
Invoice Messages
Invoice Payments
Invoice Categories
Questions? Contact support
Tasks
Show one task
GET /tasks/#{task_id}
HTTP Response: 200 Success
<task> <!-- If true task will be added as billable upon assigning it to a project --> <billable-by-default type="boolean">true</billable-by-default> <!-- False if hours can be recorded against this task. True if task is archived --> <deactivated type="boolean">false</deactivated> <default-hourly-rate type="decimal">120</default-hourly-rate> <id type="integer">1</id> <!-- If true task is added to new projects by default --> <is-default type="boolean">true</is-default> <name>UI Design</name> </task>
Show all tasks
GET /tasks
HTTP Response: 200 Success
<tasks> <task> <!-- If true task will be added as billable upon assigning it to a project --> <billable-by-default type="boolean">true</billable-by-default> <deactivated type="boolean">false</deactivated> <default-hourly-rate type="decimal">120</default-hourly-rate> <id type="integer">1</id> <!-- If true task is added to new projects by default --> <is-default type="boolean">true</is-default> <name>UI Design</name> </task> <task> ... </task> ... </tasks>
Create new task
POST /tasks
HTTP Response: 201 CreatedLocation: /tasks/#{new_task_id}
Sample post:
<task> <billable-by-default type="boolean">false</billable-by-default> <default-hourly-rate type="decimal">100</default-hourly-rate> <is-default type="boolean">false</is-default> <name>Server Admninistration</name> </task>
Delete existing task
DELETE /tasks/#{task_id}
HTTP Response: 200 OK is returned if task does not have
any hours associated.
HTTP Response: 400 Bad Request is returned if task is not removable.
Update an existing task
PUT /tasks/#{task_id}
HTTP Response: 200 OK Location: /tasks/#{task_id}
Sample post:
<task> <billable-by-default type="boolean">true</billable-by-default> <default-hourly-rate type="decimal">150</default-hourly-rate> <is-default type="boolean">true</is-default> <name>Flash design</name> </task>