Skip to main content

Create a subtask

Create a new subtask for a parent task. Subtasks help break down complex tasks into smaller, manageable pieces, making it easier to track progress and organize work.

Parameters​

title
string
required
Title of the subtask.
subtask_list
string
required
The unique identifier of the subtask list where the subtask will be created.
due_at
nullable string
Due date for the subtask in Y-m-d format (e.g., 2026-03-25).
expand
array
Array of relationships to expand. Supported values: members, parent, subtask_list.

Returns​

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

post
/api/tasks/{id}/subtasks
curl -X POST https://{workspace}.kitchen.co/api/tasks/{id}/subtasks \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Bearer {API_KEY}'
Response
{
  "completed_at": null,
  "created_at": "2026-03-21T07:52:35+00:00",
  "due_at": "2026-03-25",
  "id": "tsk_9bbcb52099a37312fbff58c8",
  "members": [],
  "parent": "tsk_9f82b648c61222c4086850c2",
  "subtask_list": "tskl_9bbcb52099a37312fbff58c8",
  "title": "The subtask title"
}