Skip to main content

The Subtask object

Subtasks allow you to break down complex tasks into smaller, manageable pieces. Each subtask belongs to a parent task and can be assigned to team members, scheduled with due dates, and tracked independently. This hierarchical structure helps organize work more effectively and provides better visibility into task progress.

Subtasks support expandable relationships, allowing related resources (such as members, the parent task, or the subtask list) to be returned either as identifiers or as full objects when expanded using the expand parameter.

Attributes​

completed_at
nullable string
Time at which the subtask was completed. Null if the subtask is not yet completed.
created_at
string
Time at which the subtask was created.
due_at
nullable string
Due date for the subtask in Y-m-d format (e.g., 2026-03-25). Null if no due date is set.
id
string
Unique identifier for the subtask.
members
array
expandable
Array of user IDs assigned to the subtask. Can be expanded to return full user objects.
parent
string
expandable
ID of the parent task that this subtask belongs to. Can be expanded to return the full task object.
subtask_list
string
expandable
ID of the subtask list that this subtask belongs to. Can be expanded to return the full subtask list object.
title
string
The title of the subtask.
The Subtask object
{
  "completed_at": "2026-03-21T07:52:35+00:00",
  "created_at": "2026-03-21T07:52:35+00:00",
  "due_at": null,
  "id": "tsk_9bbcb52099a37312fbff58c8",
  "members": [
    "u_c3715664badcadf714053dd0",
    "u_e2e07ccb713c2afe739a7c04"
  ],
  "parent": "tsk_9f82b648c61222c4086850c2",
  "subtask_list": "tskl_9bbcb52099a37312fbff58c8",
  "title": "The task title"
}