fetch-object
Read-onlyIdempotent
Retrieve full details of a specific task, project, comment, or section by ID. Optionally include direct subtasks or sub-projects to check for hidden children.
Instructions
Fetch a single task, project, comment, or section by its ID. Use this when you have a specific object ID and want to retrieve its full details. Set includeChildren to also get its direct subtasks or sub-projects.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The unique ID of the object to fetch. | |
| type | Yes | The type of object to fetch. | |
| includeChildren | No | Also return the direct children of the object: subtasks for a task, sub-projects for a project. Returns childCount plus a compact list, flagging each child that has children of its own. Use this to check whether a task hides subtasks instead of a speculative find-tasks lookup. Ignored for comments and sections. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the fetched object. | |
| type | Yes | The type of object fetched. | |
| object | Yes | The fetched object data. | |
| children | No | Direct children only: subtasks for a task, sub-projects for a project. Completed subtasks and archived sub-projects are excluded. | |
| childCount | No | The number of direct children listed in children. Only present when children were requested and the type supports them. 0 means the object definitively has none. | |
| childrenError | No | Present when the children lookup failed or returned incomplete information. When no children are listed alongside it, childCount is unknown - do not read its absence as "no children". | |
| hasMoreChildren | No | Present when the object has more than 25 direct children and the list was truncated. Page through the rest with find-tasks by parentId for subtasks, or find-projects for sub-projects. |