Toggle Sidebar

Tasks Lists

Tasks Lists allow you to group tasks together for better organization within your projects.

Available Endpoints

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

{
  "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
}

Endpoints

List Task Lists

List all project task lists.

Endpoint

https://app.trackingtime.co/api/v4/projects/:id/task_lists

Get Task List

Retrieve the task list with the given id.


Endpoint

https://app.trackingtime.co/api/v4/projects/:id/task_lists/:id

Add Task List

Create a new task list for the specified project.


Endpoint

https://app.trackingtime.co/api/v4/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.


Endpoint

https://app.trackingtime.co/api/v4/projects/:id/task_lists/update/:id

Delete Task List

Delete an existing task list.


Endpoint

https://app.trackingtime.co/api/v4projects/:id/task_lists/delete/:id

Sort Task Lists

Sort the tasks inside of this task list.


Endpoint

https://app.trackingtime.co/api/v4/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