TrackingTime API

Tasks Lists

Tasks Lists allow you to group project tasks together for better organization.

Parameters

Type Parameter Description Required
Integer id Read only
String name The task list name must is not unique YES
Integer list_position The position of the list in the project view YES
String notes Text notes up to 5,000 characters NO
Boolean is_archived When all tasks are completed the list can be closed. Default: false NO

JSON Object


{"response":{"status":200,"message":"There you go!"},"data":{
  "is_archived": false,
  "name": "New Tasks List",
  "notes": null,
  "list_position": 0,
  "tasks": [
    {
      "name": "The task with email notification",
      "project_id": 67,
      "priority": 0,
      "estimated_time": null,
      "accumulated_time": 0,
      "is_archived": false,
      "start_date": null,
      "end_date": null,
      "due_date": "2013-01-02 00:00:00",
      "skill": {
        "name": "Analysis",
        "id": 14
      },
      "user": {
        "name": "Diego",
        "surname": "Wyllie",
        "avatar_url": null,
        "id": 1
      },
      "list_position": 0,
      "list_id": 7,
      "subtasks": [],
      "comments": [],
      "worked_hours": 0.0,
      "id": 13392,
      "created_at": "2012-12-08 19:03:56",
      "updated_at": null
    }
  ],
  "id": 7,
  "created_at": "2012-12-08 18:35:39",
  "updated_at": null
}}
                

Available Endpoints

List Task Lists

List all project task lists.

Action URL

/projects/:id/task_lists

Get Task List

Retrieve the task list with the given id.

Action URL

/projects/:id/task_lists/:id

Add Task List

Create a new task list for the specified project.

Action URL

/projects/:id/task_lists/add

Parameters

Type Parameter Description Required
String name The name of the task list YES
Integer project_id The id of the project this task list belongs to NO
Integer index The index representing this task list position in the project view. If null the task list will be added at the end of the view NO

Update Task List

Update an existing task list.

Action URL

/projects/:id/task_lists/update/:id

Delete Task List

Delete an existing task list.

Action URL

projects/:id/task_lists/delete/:id

Open / Close Task List

Open / close an existing task list.

Action URL

/projects/:id/task_lists/open/:id

/projects/:id/task_lists/close/:id

Sort Task Lists

Sort the tasks inside of this task list.

Action URL

/projects/:id/task_lists/sort/:id

Parameters

Type Parameter Description Required
JSON data A json array containing tuples of the form (id,list_position) to be updated, e.g.:
[{"id":13391,"list_position":8},{"id":13384,"list_position":9}]
YES