Subtasks

• Get all subtasks
• Get subtask
• Create subtask
• Update subtask
• Complete subtask
• Delete subtask

Get all subtasks

GET v3/projects/23423233/todolists/13964085/tasks/13966758/subtasks returns all subtasks for the specified task.

[
  {
    "id": 13966722,
    "title": "Create a new document for client",
    "start_date": "2016-11-15",
    "due_date": "2016-11-20",
    "completed": false,
    "assigned": [
      12009183,
      11679192
    ],
    "labels": [
      12254912
    ]
  },
  {
    "id": 13966759,
    "title": "Send the created document to all responsible people",
    "completed": true,
    "percent_progress": 100,
    "comments": 2
  }
]

Get subtask

GET v3/projects/23423233/todolists/13964085/tasks/13966758/subtasks/13966722 returns the specified subtask.

{
  "id": 13966722,
  "title": "Create a new document for client",
  "start_date": "2016-11-15",
  "due_date": "2016-11-20",
  "estimated_hours": 10,
  "estimated_mins": 30,
  "completed": false,
  "assigned": [
    12009183,
    11679192
  ]
}

Create subtask

POST v3/projects/23423233/todolists/13964085/tasks/13966758/subtasks creates a new subtask.

{
  "title": "Get the document ready",
  "description": "Document should be ready for client approval",
  "start_date": "2016-11-10",
  "due_date": "2016-11-10",
  "estimated_hours": 5,
  "estimated_mins": 30,
  "assigned": [
    12009183
  ],
  "labels": [
    12254912
  ]
}

The assigned and labels arrays are optional.

200 OK is returned along with the created subtask.

Attachments Example

{
  "title": "Get it signed",
  "attachments": [
    {
      "id": "123456"
    }
  ]
}

Attachment IDs are obtained from the Attachments API before attaching files to a subtask.

Update subtask

PUT v3/projects/23423233/todolists/13964085/tasks/13966758/subtasks/13966722 updates an existing subtask.

{
  "description": "Get it signed off",
  "start_date": "2013-12-31",
  "due_date": "2013-12-31"
}

200 OK is returned along with the updated subtask.

Complete subtask

Use the update endpoint to mark a subtask as completed.

{
  "completed": true
}

Pass false to mark a completed subtask as incomplete.

200 OK is returned along with the updated subtask.

Delete subtask

DELETE v3/projects/23423233/todolists/13964085/tasks/13966758/subtasks/13966722 deletes the specified subtask.

204 No Content is returned if the subtask is deleted successfully. 403 Forbidden is returned if access is denied.