get_tasks
Retrieve tasks for a specified goal, optionally including subtasks or deleted tasks. Supports hierarchical task structures and customizable response formats to suit specific needs.
Instructions
Get tasks for a goal. Task IDs use a dot-notation (e.g., "1", "1.1", "1.1.1"). When includeSubtasks
is specified, responses will return hierarchical task objects. Otherwise, simplified task objects without createdAt
, updatedAt
, or parentId
will be returned.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
goalId | Yes | ID of the goal to get tasks for (number) | |
includeDeletedTasks | No | Whether to include soft-deleted tasks in the results (boolean). Defaults to false. | |
includeSubtasks | No | Level of subtasks to include: "none" (only top-level tasks), "first-level" (top-level tasks and their direct children), or "recursive" (all nested subtasks). Defaults to "none". | none |
taskIds | No | Optional: IDs of tasks to fetch (array of strings). If null or empty, all tasks for the goal will be fetched. |
Input Schema (JSON Schema)
{
"properties": {
"goalId": {
"description": "ID of the goal to get tasks for (number)",
"type": "number"
},
"includeDeletedTasks": {
"default": false,
"description": "Whether to include soft-deleted tasks in the results (boolean). Defaults to false.",
"type": "boolean"
},
"includeSubtasks": {
"default": "none",
"description": "Level of subtasks to include: \"none\" (only top-level tasks), \"first-level\" (top-level tasks and their direct children), or \"recursive\" (all nested subtasks). Defaults to \"none\".",
"enum": [
"none",
"first-level",
"recursive"
],
"type": "string"
},
"taskIds": {
"description": "Optional: IDs of tasks to fetch (array of strings). If null or empty, all tasks for the goal will be fetched.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"goalId"
],
"type": "object"
}