Find here the list of actions to apply on the objects, and the data reference for this object.

What is a task ?

A task is a to-do item.

Getting the tasks list

GET /tasks.xml

Returns all tasks, page by page
Add a page parameter to navigate

Getting a single task

GET /tasks/#{id}.xml

Returns a single task, identified by its id

Creating a new task

POST /tasks.xml

Creates a new task, and returns the task data

Updating an existing task

PUT /tasks/#{id}.xml

Updates some fields of an existing task

Deleting an existing task

DELETE /tasks/#{id}.xml

Deletes the task identified by its id

Object data

<task>
 <id>id of the task</id>
 <title>title</title>
 <content>content</content>
 <type_id>importance id (see below)</type_id>
 <service_id>service id (see below)</service_id>
 <status_id>status id (see below)</status_id>
 <priority_id>priority id (see below)</priority_id>
 <assigned_user_id>id of user to which the task is assigned</assigned_user_id>
 <project_id>id of the project this task belongs to</project_id>
 <due_at>due date</due_at>
 <done_at>date at which the task was terminated</done_at>
 <object_name>name of object to which the task is attached (if any)</object_name>
 <object_zid>id of object to which the task is attached (if any)</object_zid>
</task>

Possible values of task status

• 236 if pending

• 237 if complete

• 238 if canceled

• 239 if archived

Possible values of service

• 79 for sales

• 80 for documents

• 81 for direction

• 82 for human resources

• 83 for marketing

• 84 for purchases

• 85 for administrative

• 525 for research & development

• 575 for it

• 620 for not worked

Possible values of task priority

• 257 if high

• 258 if normal

• 259 if low

Possible values of task importance

• 46 if high importance

• 44 if normal importance

• 45 if low importance