Skip to main content

Update a subtask

Use this endpoint to update specific details of a subtask. Simply pass the parameters you want to change, and the subtask will be updated accordingly. Any parameters you don't include in the request will remain unchanged, ensuring that you only modify what's necessary without affecting other aspects of the subtask.

Parameters​

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

Returns​

Returns the subtask object if the update succeeded. Throws an error if update parameters are invalid.

put
/api/tasks/{taskId}/subtasks/{subtaskId}
curl -X PUT https://{workspace}.kitchen.co/api/tasks/{taskId}/subtasks/{subtaskId} \
    -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 updated subtask title"
}