Skip to main content

Create a subtask list

Create a new subtask list on a task. Subtask lists work like checklists: they group subtasks under a named list so you can track progress and organize work.

Parameters​

name
string
required
Name of the subtask list.
expand
array
Array of relationships to expand. Supported values: task, subtasks.

Returns​

Returns the created subtask list object. Throws an error if some parameters are not valid.

post
/api/tasks/{id}/subtask-lists
curl -X POST https://{workspace}.kitchen.co/api/tasks/{id}/subtask-lists \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Bearer {API_KEY}'
Response
{
  "id": "tskl_9bbcb52099a37312fbff58c8",
  "name": "Checklist name",
  "task": "tsk_9bbcb52099a37312fbff58c8",
  "subtasks": [],
  "createdAt": "2024-03-21T07:52:35+00:00",
  "updatedAt": "2024-03-21T07:52:35+00:00"
}