Skip to main content
Glama
Doist
by Doist

fetch-object

Read-onlyIdempotent

Retrieve full details of any Todoist task, project, comment, or section by ID. Optionally include 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
NameRequiredDescriptionDefault
idYesThe unique ID of the object to fetch.
typeYesThe type of object to fetch.
includeChildrenNoAlso 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
NameRequiredDescriptionDefault
idYesThe ID of the fetched object.
typeYesThe type of object fetched.
objectYesThe fetched object data.
childrenNoDirect children only: subtasks for a task, sub-projects for a project. Completed subtasks and archived sub-projects are excluded.
childCountNoThe 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.
childrenErrorNoPresent 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".
hasMoreChildrenNoPresent 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.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv13.3.0
    • changedOutput schema / properties / object / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "addedAt": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "assignedByUid": {
      -        "type": "string"
      -      },
      -      "checked": {
      -        "description": "Whether the task is completed.",
      -        "type": "boolean"
      -      },
      -      "completedAt": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "content": {
      -        "description": "Task title.",
      -        "type": "string"
      -      },
      -      "deadlineDate": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "description": {
      -        "type": "string"
      -      },
      -      "dueDate": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "duration": {
      -        "description": "e.g. \"2h30m\".",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "isDeleted": {
      -        "description": "True when deleted; absent otherwise.",
      -        "type": "boolean"
      -      },
      -      "isUncompletable": {
      -        "description": "An organizational header, not a real task.",
      -        "type": "boolean"
      -      },
      -      "labels": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "parentId": {
      -        "type": "string"
      -      },
      -      "priority": {
      -        "description": "p1 is highest, p4 lowest.",
      -        "enum": [
      -          "p1",
      -          "p2",
      -          "p3",
      -          "p4"
      -        ],
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "type": "string"
      -      },
      -      "recurring": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "string"
      -          }
      -        ],
      -        "description": "False when not recurring, otherwise the recurrence string."
      -      },
      -      "responsibleUid": {
      -        "type": "string"
      -      },
      -      "sectionId": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "description",
      -      "recurring",
      -      "priority",
      -      "projectId",
      -      "checked"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "childOrder": {
      -        "description": "Ordering index among siblings.",
      -        "type": "number"
      -      },
      -      "color": {
      -        "enum": [
      -          "berry_red",
      -          "red",
      -          "orange",
      -          "yellow",
      -          "olive_green",
      -          "lime_green",
      -          "green",
      -          "mint_green",
      -          "teal",
      -          "sky_blue",
      -          "light_blue",
      -          "blue",
      -          "grape",
      -          "violet",
      -          "lavender",
      -          "magenta",
      -          "salmon",
      -          "charcoal",
      -          "grey",
      -          "taupe"
      -        ],
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "Empty string when none.",
      -        "type": "string"
      -      },
      -      "folderId": {
      -        "description": "Workspace projects only.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "inboxProject": {
      -        "type": "boolean"
      -      },
      -      "isArchived": {
      -        "type": "boolean"
      -      },
      -      "isFavorite": {
      -        "type": "boolean"
      -      },
      -      "isShared": {
      -        "type": "boolean"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "parentId": {
      -        "type": "string"
      -      },
      -      "viewStyle": {
      -        "description": "list, board or calendar.",
      -        "type": "string"
      -      },
      -      "workspaceId": {
      -        "description": "Undefined for personal projects.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name",
      -      "description",
      -      "isFavorite",
      -      "isShared",
      -      "inboxProject",
      -      "viewStyle",
      -      "childOrder",
      -      "isArchived"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "content": {
      -        "type": "string"
      -      },
      -      "fileAttachment": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "fileDuration": {
      -            "description": "Milliseconds, for audio/video.",
      -            "type": "number"
      -          },
      -          "fileName": {
      -            "type": "string"
      -          },
      -          "fileSize": {
      -            "description": "Bytes.",
      -            "type": "number"
      -          },
      -          "fileType": {
      -            "description": "MIME type.",
      -            "type": "string"
      -          },
      -          "fileUrl": {
      -            "type": "string"
      -          },
      -          "image": {
      -            "description": "For image resource types.",
      -            "type": "string"
      -          },
      -          "imageHeight": {
      -            "description": "Pixels.",
      -            "type": "number"
      -          },
      -          "imageWidth": {
      -            "description": "Pixels.",
      -            "type": "number"
      -          },
      -          "resourceType": {
      -            "description": "file, url, image, etc.",
      -            "type": "string"
      -          },
      -          "title": {
      -            "description": "For link/url resource types.",
      -            "type": "string"
      -          },
      -          "uploadState": {
      -            "enum": [
      -              "pending",
      -              "completed"
      -            ],
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "For link/url resource types.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "resourceType"
      -        ],
      -        "type": "object"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "notifiedUserIds": {
      -        "description": "Users notified about this comment. Absent when nobody was notified.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "postedAt": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "postedUid": {
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "type": "string"
      -      },
      -      "taskId": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "postedAt"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "description": {
      -        "description": "Supports Markdown.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "sectionOrder": {
      -        "description": "Ordering index within the project.",
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name",
      -      "sectionOrder"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "addedAt": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "assignedByUid": {
      +        "type": "string"
      +      },
      +      "checked": {
      +        "description": "Whether the task is completed.",
      +        "type": "boolean"
      +      },
      +      "completedAt": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "content": {
      +        "description": "Task title.",
      +        "type": "string"
      +      },
      +      "deadlineDate": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "description": {
      +        "type": "string"
      +      },
      +      "dueDate": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "duration": {
      +        "description": "e.g. \"2h30m\", or \"3d\" for a day-based duration.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "isDeleted": {
      +        "description": "True when deleted; absent otherwise.",
      +        "type": "boolean"
      +      },
      +      "isUncompletable": {
      +        "description": "An organizational header, not a real task.",
      +        "type": "boolean"
      +      },
      +      "labels": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "parentId": {
      +        "type": "string"
      +      },
      +      "priority": {
      +        "description": "p1 is highest, p4 lowest.",
      +        "enum": [
      +          "p1",
      +          "p2",
      +          "p3",
      +          "p4"
      +        ],
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "type": "string"
      +      },
      +      "recurring": {
      +        "anyOf": [
      +          {
      +            "type": "boolean"
      +          },
      +          {
      +            "type": "string"
      +          }
      +        ],
      +        "description": "False when not recurring, otherwise the recurrence string."
      +      },
      +      "responsibleUid": {
      +        "type": "string"
      +      },
      +      "sectionId": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "description",
      +      "recurring",
      +      "priority",
      +      "projectId",
      +      "checked"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "childOrder": {
      +        "description": "Ordering index among siblings.",
      +        "type": "number"
      +      },
      +      "color": {
      +        "enum": [
      +          "berry_red",
      +          "red",
      +          "orange",
      +          "yellow",
      +          "olive_green",
      +          "lime_green",
      +          "green",
      +          "mint_green",
      +          "teal",
      +          "sky_blue",
      +          "light_blue",
      +          "blue",
      +          "grape",
      +          "violet",
      +          "lavender",
      +          "magenta",
      +          "salmon",
      +          "charcoal",
      +          "grey",
      +          "taupe"
      +        ],
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "Empty string when none.",
      +        "type": "string"
      +      },
      +      "folderId": {
      +        "description": "Workspace projects only.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "inboxProject": {
      +        "type": "boolean"
      +      },
      +      "isArchived": {
      +        "type": "boolean"
      +      },
      +      "isFavorite": {
      +        "type": "boolean"
      +      },
      +      "isShared": {
      +        "type": "boolean"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "parentId": {
      +        "type": "string"
      +      },
      +      "viewStyle": {
      +        "description": "list, board or calendar.",
      +        "type": "string"
      +      },
      +      "workspaceId": {
      +        "description": "Undefined for personal projects.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "description",
      +      "isFavorite",
      +      "isShared",
      +      "inboxProject",
      +      "viewStyle",
      +      "childOrder",
      +      "isArchived"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "content": {
      +        "type": "string"
      +      },
      +      "fileAttachment": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "fileDuration": {
      +            "description": "Milliseconds, for audio/video.",
      +            "type": "number"
      +          },
      +          "fileName": {
      +            "type": "string"
      +          },
      +          "fileSize": {
      +            "description": "Bytes.",
      +            "type": "number"
      +          },
      +          "fileType": {
      +            "description": "MIME type.",
      +            "type": "string"
      +          },
      +          "fileUrl": {
      +            "type": "string"
      +          },
      +          "image": {
      +            "description": "For image resource types.",
      +            "type": "string"
      +          },
      +          "imageHeight": {
      +            "description": "Pixels.",
      +            "type": "number"
      +          },
      +          "imageWidth": {
      +            "description": "Pixels.",
      +            "type": "number"
      +          },
      +          "resourceType": {
      +            "description": "file, url, image, etc.",
      +            "type": "string"
      +          },
      +          "title": {
      +            "description": "For link/url resource types.",
      +            "type": "string"
      +          },
      +          "uploadState": {
      +            "enum": [
      +              "pending",
      +              "completed"
      +            ],
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "For link/url resource types.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "resourceType"
      +        ],
      +        "type": "object"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "notifiedUserIds": {
      +        "description": "Users notified about this comment. Absent when nobody was notified.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "postedAt": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "postedUid": {
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "type": "string"
      +      },
      +      "taskId": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "postedAt"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "description": {
      +        "description": "Supports Markdown.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "sectionOrder": {
      +        "description": "Ordering index within the project.",
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "sectionOrder"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed1 schema field changedv13.2.7
    • changedOutput schema / properties / object / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "addedAt": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "assignedByUid": {
      -        "type": "string"
      -      },
      -      "checked": {
      -        "description": "Whether the task is completed.",
      -        "type": "boolean"
      -      },
      -      "completedAt": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "content": {
      -        "description": "Task title.",
      -        "type": "string"
      -      },
      -      "deadlineDate": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "description": {
      -        "type": "string"
      -      },
      -      "dueDate": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "duration": {
      -        "description": "e.g. \"2h30m\".",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "isUncompletable": {
      -        "description": "An organizational header, not a real task.",
      -        "type": "boolean"
      -      },
      -      "labels": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "parentId": {
      -        "type": "string"
      -      },
      -      "priority": {
      -        "description": "p1 is highest, p4 lowest.",
      -        "enum": [
      -          "p1",
      -          "p2",
      -          "p3",
      -          "p4"
      -        ],
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "type": "string"
      -      },
      -      "recurring": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "string"
      -          }
      -        ],
      -        "description": "False when not recurring, otherwise the recurrence string."
      -      },
      -      "responsibleUid": {
      -        "type": "string"
      -      },
      -      "sectionId": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "description",
      -      "recurring",
      -      "priority",
      -      "projectId",
      -      "checked"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "childOrder": {
      -        "description": "Ordering index among siblings.",
      -        "type": "number"
      -      },
      -      "color": {
      -        "enum": [
      -          "berry_red",
      -          "red",
      -          "orange",
      -          "yellow",
      -          "olive_green",
      -          "lime_green",
      -          "green",
      -          "mint_green",
      -          "teal",
      -          "sky_blue",
      -          "light_blue",
      -          "blue",
      -          "grape",
      -          "violet",
      -          "lavender",
      -          "magenta",
      -          "salmon",
      -          "charcoal",
      -          "grey",
      -          "taupe"
      -        ],
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "Empty string when none.",
      -        "type": "string"
      -      },
      -      "folderId": {
      -        "description": "Workspace projects only.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "inboxProject": {
      -        "type": "boolean"
      -      },
      -      "isArchived": {
      -        "type": "boolean"
      -      },
      -      "isFavorite": {
      -        "type": "boolean"
      -      },
      -      "isShared": {
      -        "type": "boolean"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "parentId": {
      -        "type": "string"
      -      },
      -      "viewStyle": {
      -        "description": "list, board or calendar.",
      -        "type": "string"
      -      },
      -      "workspaceId": {
      -        "description": "Undefined for personal projects.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name",
      -      "description",
      -      "isFavorite",
      -      "isShared",
      -      "inboxProject",
      -      "viewStyle",
      -      "childOrder",
      -      "isArchived"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "content": {
      -        "type": "string"
      -      },
      -      "fileAttachment": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "fileDuration": {
      -            "description": "Milliseconds, for audio/video.",
      -            "type": "number"
      -          },
      -          "fileName": {
      -            "type": "string"
      -          },
      -          "fileSize": {
      -            "description": "Bytes.",
      -            "type": "number"
      -          },
      -          "fileType": {
      -            "description": "MIME type.",
      -            "type": "string"
      -          },
      -          "fileUrl": {
      -            "type": "string"
      -          },
      -          "image": {
      -            "description": "For image resource types.",
      -            "type": "string"
      -          },
      -          "imageHeight": {
      -            "description": "Pixels.",
      -            "type": "number"
      -          },
      -          "imageWidth": {
      -            "description": "Pixels.",
      -            "type": "number"
      -          },
      -          "resourceType": {
      -            "description": "file, url, image, etc.",
      -            "type": "string"
      -          },
      -          "title": {
      -            "description": "For link/url resource types.",
      -            "type": "string"
      -          },
      -          "uploadState": {
      -            "enum": [
      -              "pending",
      -              "completed"
      -            ],
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "For link/url resource types.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "resourceType"
      -        ],
      -        "type": "object"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "notifiedUserIds": {
      -        "description": "Users notified about this comment. Absent when nobody was notified.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "postedAt": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "postedUid": {
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "type": "string"
      -      },
      -      "taskId": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "postedAt"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "description": {
      -        "description": "Supports Markdown.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "sectionOrder": {
      -        "description": "Ordering index within the project.",
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name",
      -      "sectionOrder"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "addedAt": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "assignedByUid": {
      +        "type": "string"
      +      },
      +      "checked": {
      +        "description": "Whether the task is completed.",
      +        "type": "boolean"
      +      },
      +      "completedAt": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "content": {
      +        "description": "Task title.",
      +        "type": "string"
      +      },
      +      "deadlineDate": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "description": {
      +        "type": "string"
      +      },
      +      "dueDate": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "duration": {
      +        "description": "e.g. \"2h30m\".",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "isDeleted": {
      +        "description": "True when deleted; absent otherwise.",
      +        "type": "boolean"
      +      },
      +      "isUncompletable": {
      +        "description": "An organizational header, not a real task.",
      +        "type": "boolean"
      +      },
      +      "labels": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "parentId": {
      +        "type": "string"
      +      },
      +      "priority": {
      +        "description": "p1 is highest, p4 lowest.",
      +        "enum": [
      +          "p1",
      +          "p2",
      +          "p3",
      +          "p4"
      +        ],
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "type": "string"
      +      },
      +      "recurring": {
      +        "anyOf": [
      +          {
      +            "type": "boolean"
      +          },
      +          {
      +            "type": "string"
      +          }
      +        ],
      +        "description": "False when not recurring, otherwise the recurrence string."
      +      },
      +      "responsibleUid": {
      +        "type": "string"
      +      },
      +      "sectionId": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "description",
      +      "recurring",
      +      "priority",
      +      "projectId",
      +      "checked"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "childOrder": {
      +        "description": "Ordering index among siblings.",
      +        "type": "number"
      +      },
      +      "color": {
      +        "enum": [
      +          "berry_red",
      +          "red",
      +          "orange",
      +          "yellow",
      +          "olive_green",
      +          "lime_green",
      +          "green",
      +          "mint_green",
      +          "teal",
      +          "sky_blue",
      +          "light_blue",
      +          "blue",
      +          "grape",
      +          "violet",
      +          "lavender",
      +          "magenta",
      +          "salmon",
      +          "charcoal",
      +          "grey",
      +          "taupe"
      +        ],
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "Empty string when none.",
      +        "type": "string"
      +      },
      +      "folderId": {
      +        "description": "Workspace projects only.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "inboxProject": {
      +        "type": "boolean"
      +      },
      +      "isArchived": {
      +        "type": "boolean"
      +      },
      +      "isFavorite": {
      +        "type": "boolean"
      +      },
      +      "isShared": {
      +        "type": "boolean"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "parentId": {
      +        "type": "string"
      +      },
      +      "viewStyle": {
      +        "description": "list, board or calendar.",
      +        "type": "string"
      +      },
      +      "workspaceId": {
      +        "description": "Undefined for personal projects.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "description",
      +      "isFavorite",
      +      "isShared",
      +      "inboxProject",
      +      "viewStyle",
      +      "childOrder",
      +      "isArchived"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "content": {
      +        "type": "string"
      +      },
      +      "fileAttachment": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "fileDuration": {
      +            "description": "Milliseconds, for audio/video.",
      +            "type": "number"
      +          },
      +          "fileName": {
      +            "type": "string"
      +          },
      +          "fileSize": {
      +            "description": "Bytes.",
      +            "type": "number"
      +          },
      +          "fileType": {
      +            "description": "MIME type.",
      +            "type": "string"
      +          },
      +          "fileUrl": {
      +            "type": "string"
      +          },
      +          "image": {
      +            "description": "For image resource types.",
      +            "type": "string"
      +          },
      +          "imageHeight": {
      +            "description": "Pixels.",
      +            "type": "number"
      +          },
      +          "imageWidth": {
      +            "description": "Pixels.",
      +            "type": "number"
      +          },
      +          "resourceType": {
      +            "description": "file, url, image, etc.",
      +            "type": "string"
      +          },
      +          "title": {
      +            "description": "For link/url resource types.",
      +            "type": "string"
      +          },
      +          "uploadState": {
      +            "enum": [
      +              "pending",
      +              "completed"
      +            ],
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "For link/url resource types.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "resourceType"
      +        ],
      +        "type": "object"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "notifiedUserIds": {
      +        "description": "Users notified about this comment. Absent when nobody was notified.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "postedAt": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "postedUid": {
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "type": "string"
      +      },
      +      "taskId": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "postedAt"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "description": {
      +        "description": "Supports Markdown.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "sectionOrder": {
      +        "description": "Ordering index within the project.",
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "sectionOrder"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed2 schema fields changedv13.0.0
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • changedOutput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
  4. Changed1 schema field changedv12.6.0
    • changedOutput schema / properties / object / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "addedAt": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "assignedByUid": {
      -        "type": "string"
      -      },
      -      "checked": {
      -        "description": "Whether the task is completed.",
      -        "type": "boolean"
      -      },
      -      "completedAt": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "content": {
      -        "description": "Task title.",
      -        "type": "string"
      -      },
      -      "deadlineDate": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "description": {
      -        "type": "string"
      -      },
      -      "dueDate": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "duration": {
      -        "description": "e.g. \"2h30m\".",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "isUncompletable": {
      -        "description": "An organizational header, not a real task.",
      -        "type": "boolean"
      -      },
      -      "labels": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "parentId": {
      -        "type": "string"
      -      },
      -      "priority": {
      -        "description": "p1 is highest, p4 lowest.",
      -        "enum": [
      -          "p1",
      -          "p2",
      -          "p3",
      -          "p4"
      -        ],
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "type": "string"
      -      },
      -      "recurring": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "string"
      -          }
      -        ],
      -        "description": "False when not recurring, otherwise the recurrence string."
      -      },
      -      "responsibleUid": {
      -        "type": "string"
      -      },
      -      "sectionId": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "description",
      -      "recurring",
      -      "priority",
      -      "projectId",
      -      "checked"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "childOrder": {
      -        "description": "Ordering index among siblings.",
      -        "type": "number"
      -      },
      -      "color": {
      -        "enum": [
      -          "berry_red",
      -          "red",
      -          "orange",
      -          "yellow",
      -          "olive_green",
      -          "lime_green",
      -          "green",
      -          "mint_green",
      -          "teal",
      -          "sky_blue",
      -          "light_blue",
      -          "blue",
      -          "grape",
      -          "violet",
      -          "lavender",
      -          "magenta",
      -          "salmon",
      -          "charcoal",
      -          "grey",
      -          "taupe"
      -        ],
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "Empty string when none.",
      -        "type": "string"
      -      },
      -      "folderId": {
      -        "description": "Workspace projects only.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "inboxProject": {
      -        "type": "boolean"
      -      },
      -      "isArchived": {
      -        "type": "boolean"
      -      },
      -      "isFavorite": {
      -        "type": "boolean"
      -      },
      -      "isShared": {
      -        "type": "boolean"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "parentId": {
      -        "type": "string"
      -      },
      -      "viewStyle": {
      -        "description": "list, board or calendar.",
      -        "type": "string"
      -      },
      -      "workspaceId": {
      -        "description": "Undefined for personal projects.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name",
      -      "description",
      -      "isFavorite",
      -      "isShared",
      -      "inboxProject",
      -      "viewStyle",
      -      "childOrder",
      -      "isArchived"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "content": {
      -        "type": "string"
      -      },
      -      "fileAttachment": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "fileDuration": {
      -            "description": "Milliseconds, for audio/video.",
      -            "type": "number"
      -          },
      -          "fileName": {
      -            "type": "string"
      -          },
      -          "fileSize": {
      -            "description": "Bytes.",
      -            "type": "number"
      -          },
      -          "fileType": {
      -            "description": "MIME type.",
      -            "type": "string"
      -          },
      -          "fileUrl": {
      -            "type": "string"
      -          },
      -          "image": {
      -            "description": "For image resource types.",
      -            "type": "string"
      -          },
      -          "imageHeight": {
      -            "description": "Pixels.",
      -            "type": "number"
      -          },
      -          "imageWidth": {
      -            "description": "Pixels.",
      -            "type": "number"
      -          },
      -          "resourceType": {
      -            "description": "file, url, image, etc.",
      -            "type": "string"
      -          },
      -          "title": {
      -            "description": "For link/url resource types.",
      -            "type": "string"
      -          },
      -          "uploadState": {
      -            "enum": [
      -              "pending",
      -              "completed"
      -            ],
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "For link/url resource types.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "resourceType"
      -        ],
      -        "type": "object"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "postedAt": {
      -        "description": "ISO 8601.",
      -        "type": "string"
      -      },
      -      "postedUid": {
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "type": "string"
      -      },
      -      "taskId": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "postedAt"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "description": {
      -        "description": "Supports Markdown.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "sectionOrder": {
      -        "description": "Ordering index within the project.",
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name",
      -      "sectionOrder"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "addedAt": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "assignedByUid": {
      +        "type": "string"
      +      },
      +      "checked": {
      +        "description": "Whether the task is completed.",
      +        "type": "boolean"
      +      },
      +      "completedAt": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "content": {
      +        "description": "Task title.",
      +        "type": "string"
      +      },
      +      "deadlineDate": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "description": {
      +        "type": "string"
      +      },
      +      "dueDate": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "duration": {
      +        "description": "e.g. \"2h30m\".",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "isUncompletable": {
      +        "description": "An organizational header, not a real task.",
      +        "type": "boolean"
      +      },
      +      "labels": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "parentId": {
      +        "type": "string"
      +      },
      +      "priority": {
      +        "description": "p1 is highest, p4 lowest.",
      +        "enum": [
      +          "p1",
      +          "p2",
      +          "p3",
      +          "p4"
      +        ],
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "type": "string"
      +      },
      +      "recurring": {
      +        "anyOf": [
      +          {
      +            "type": "boolean"
      +          },
      +          {
      +            "type": "string"
      +          }
      +        ],
      +        "description": "False when not recurring, otherwise the recurrence string."
      +      },
      +      "responsibleUid": {
      +        "type": "string"
      +      },
      +      "sectionId": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "description",
      +      "recurring",
      +      "priority",
      +      "projectId",
      +      "checked"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "childOrder": {
      +        "description": "Ordering index among siblings.",
      +        "type": "number"
      +      },
      +      "color": {
      +        "enum": [
      +          "berry_red",
      +          "red",
      +          "orange",
      +          "yellow",
      +          "olive_green",
      +          "lime_green",
      +          "green",
      +          "mint_green",
      +          "teal",
      +          "sky_blue",
      +          "light_blue",
      +          "blue",
      +          "grape",
      +          "violet",
      +          "lavender",
      +          "magenta",
      +          "salmon",
      +          "charcoal",
      +          "grey",
      +          "taupe"
      +        ],
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "Empty string when none.",
      +        "type": "string"
      +      },
      +      "folderId": {
      +        "description": "Workspace projects only.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "inboxProject": {
      +        "type": "boolean"
      +      },
      +      "isArchived": {
      +        "type": "boolean"
      +      },
      +      "isFavorite": {
      +        "type": "boolean"
      +      },
      +      "isShared": {
      +        "type": "boolean"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "parentId": {
      +        "type": "string"
      +      },
      +      "viewStyle": {
      +        "description": "list, board or calendar.",
      +        "type": "string"
      +      },
      +      "workspaceId": {
      +        "description": "Undefined for personal projects.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "description",
      +      "isFavorite",
      +      "isShared",
      +      "inboxProject",
      +      "viewStyle",
      +      "childOrder",
      +      "isArchived"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "content": {
      +        "type": "string"
      +      },
      +      "fileAttachment": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "fileDuration": {
      +            "description": "Milliseconds, for audio/video.",
      +            "type": "number"
      +          },
      +          "fileName": {
      +            "type": "string"
      +          },
      +          "fileSize": {
      +            "description": "Bytes.",
      +            "type": "number"
      +          },
      +          "fileType": {
      +            "description": "MIME type.",
      +            "type": "string"
      +          },
      +          "fileUrl": {
      +            "type": "string"
      +          },
      +          "image": {
      +            "description": "For image resource types.",
      +            "type": "string"
      +          },
      +          "imageHeight": {
      +            "description": "Pixels.",
      +            "type": "number"
      +          },
      +          "imageWidth": {
      +            "description": "Pixels.",
      +            "type": "number"
      +          },
      +          "resourceType": {
      +            "description": "file, url, image, etc.",
      +            "type": "string"
      +          },
      +          "title": {
      +            "description": "For link/url resource types.",
      +            "type": "string"
      +          },
      +          "uploadState": {
      +            "enum": [
      +              "pending",
      +              "completed"
      +            ],
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "For link/url resource types.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "resourceType"
      +        ],
      +        "type": "object"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "notifiedUserIds": {
      +        "description": "Users notified about this comment. Absent when nobody was notified.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "postedAt": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "postedUid": {
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "type": "string"
      +      },
      +      "taskId": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "postedAt"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "description": {
      +        "description": "Supports Markdown.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "sectionOrder": {
      +        "description": "Ordering index within the project.",
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "sectionOrder"
      +    ],
      +    "type": "object"
      +  }
      +]
  5. Changed2 schema fields changedv12.5.3
    • changedOutput schema / properties / children / items / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "checked": {
      -        "description": "Whether the task is checked/completed.",
      -        "type": "boolean"
      -      },
      -      "content": {
      -        "description": "The task title/content.",
      -        "type": "string"
      -      },
      -      "dueDate": {
      -        "description": "The due date of the task (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "hasChildren": {
      -        "description": "Whether this subtask has subtasks of its own. Fetch it with includeChildren to expand.",
      -        "type": "boolean"
      -      },
      -      "id": {
      -        "description": "The unique ID of the task.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "checked",
      -      "hasChildren"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "hasChildren": {
      -        "description": "Whether this sub-project has sub-projects of its own. Fetch it with includeChildren to expand.",
      -        "type": "boolean"
      -      },
      -      "id": {
      -        "description": "The unique ID of the project.",
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "The name of the project.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name",
      -      "hasChildren"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "checked": {
      +        "description": "Whether the task is completed.",
      +        "type": "boolean"
      +      },
      +      "content": {
      +        "description": "Task title.",
      +        "type": "string"
      +      },
      +      "dueDate": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "hasChildren": {
      +        "description": "Whether this subtask has subtasks of its own. Fetch it with includeChildren to expand.",
      +        "type": "boolean"
      +      },
      +      "id": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "checked",
      +      "hasChildren"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "hasChildren": {
      +        "description": "Whether this sub-project has sub-projects of its own. Fetch it with includeChildren to expand.",
      +        "type": "boolean"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "hasChildren"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedOutput schema / properties / object / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "addedAt": {
      -        "description": "When the task was created (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "assignedByUid": {
      -        "description": "The UID of the user who assigned this task.",
      -        "type": "string"
      -      },
      -      "checked": {
      -        "description": "Whether the task is checked/completed.",
      -        "type": "boolean"
      -      },
      -      "completedAt": {
      -        "description": "When the task was completed (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "content": {
      -        "description": "The task title/content.",
      -        "type": "string"
      -      },
      -      "deadlineDate": {
      -        "description": "The deadline date of the task (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "The task description.",
      -        "type": "string"
      -      },
      -      "dueDate": {
      -        "description": "The due date of the task (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "duration": {
      -        "description": "The duration of the task (e.g., \"2h30m\").",
      -        "type": "string"
      -      },
      -      "id": {
      -        "description": "The unique ID of the task.",
      -        "type": "string"
      -      },
      -      "isUncompletable": {
      -        "description": "Whether the task is uncompletable (organizational header).",
      -        "type": "boolean"
      -      },
      -      "labels": {
      -        "description": "The labels attached to this task.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "parentId": {
      -        "description": "The ID of the parent task (for subtasks).",
      -        "type": "string"
      -      },
      -      "priority": {
      -        "description": "The priority level: p1 (highest), p2 (high), p3 (medium), p4 (lowest).",
      -        "enum": [
      -          "p1",
      -          "p2",
      -          "p3",
      -          "p4"
      -        ],
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "description": "The ID of the project this task belongs to.",
      -        "type": "string"
      -      },
      -      "recurring": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "string"
      -          }
      -        ],
      -        "description": "Whether the task is recurring, or the recurrence string."
      -      },
      -      "responsibleUid": {
      -        "description": "The UID of the user responsible for this task.",
      -        "type": "string"
      -      },
      -      "sectionId": {
      -        "description": "The ID of the section this task belongs to.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "description",
      -      "recurring",
      -      "priority",
      -      "projectId",
      -      "checked"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "childOrder": {
      -        "description": "The ordering index of the project among its siblings.",
      -        "type": "number"
      -      },
      -      "color": {
      -        "description": "The color key of the entity.",
      -        "enum": [
      -          "berry_red",
      -          "red",
      -          "orange",
      -          "yellow",
      -          "olive_green",
      -          "lime_green",
      -          "green",
      -          "mint_green",
      -          "teal",
      -          "sky_blue",
      -          "light_blue",
      -          "blue",
      -          "grape",
      -          "violet",
      -          "lavender",
      -          "magenta",
      -          "salmon",
      -          "charcoal",
      -          "grey",
      -          "taupe"
      -        ],
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "The description of the project (empty string if none).",
      -        "type": "string"
      -      },
      -      "folderId": {
      -        "description": "The ID of the folder this project belongs to (workspace projects only).",
      -        "type": "string"
      -      },
      -      "id": {
      -        "description": "The unique ID of the project.",
      -        "type": "string"
      -      },
      -      "inboxProject": {
      -        "description": "Whether this is the inbox project.",
      -        "type": "boolean"
      -      },
      -      "isArchived": {
      -        "description": "Whether the project is archived.",
      -        "type": "boolean"
      -      },
      -      "isFavorite": {
      -        "description": "Whether the project is marked as favorite.",
      -        "type": "boolean"
      -      },
      -      "isShared": {
      -        "description": "Whether the project is shared.",
      -        "type": "boolean"
      -      },
      -      "name": {
      -        "description": "The name of the project.",
      -        "type": "string"
      -      },
      -      "parentId": {
      -        "description": "The ID of the parent project (for sub-projects).",
      -        "type": "string"
      -      },
      -      "viewStyle": {
      -        "description": "The view style of the project (list, board, calendar).",
      -        "type": "string"
      -      },
      -      "workspaceId": {
      -        "description": "The ID of the workspace this project belongs to (undefined for personal projects).",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name",
      -      "description",
      -      "isFavorite",
      -      "isShared",
      -      "inboxProject",
      -      "viewStyle",
      -      "childOrder",
      -      "isArchived"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "content": {
      -        "description": "The content of the comment.",
      -        "type": "string"
      -      },
      -      "fileAttachment": {
      -        "additionalProperties": false,
      -        "description": "File attachment information, if any.",
      -        "properties": {
      -          "fileDuration": {
      -            "description": "The duration in milliseconds (for audio/video files).",
      -            "type": "number"
      -          },
      -          "fileName": {
      -            "description": "The name of the file.",
      -            "type": "string"
      -          },
      -          "fileSize": {
      -            "description": "The size of the file in bytes.",
      -            "type": "number"
      -          },
      -          "fileType": {
      -            "description": "The MIME type of the file.",
      -            "type": "string"
      -          },
      -          "fileUrl": {
      -            "description": "The URL to access the file.",
      -            "type": "string"
      -          },
      -          "image": {
      -            "description": "The image URL for image resource types.",
      -            "type": "string"
      -          },
      -          "imageHeight": {
      -            "description": "The height of the image in pixels.",
      -            "type": "number"
      -          },
      -          "imageWidth": {
      -            "description": "The width of the image in pixels.",
      -            "type": "number"
      -          },
      -          "resourceType": {
      -            "description": "The type of resource (file, url, image, etc).",
      -            "type": "string"
      -          },
      -          "title": {
      -            "description": "The title for link/url resource types.",
      -            "type": "string"
      -          },
      -          "uploadState": {
      -            "description": "The upload state of the file.",
      -            "enum": [
      -              "pending",
      -              "completed"
      -            ],
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The URL for link/url resource types.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "resourceType"
      -        ],
      -        "type": "object"
      -      },
      -      "id": {
      -        "description": "The unique ID of the comment.",
      -        "type": "string"
      -      },
      -      "postedAt": {
      -        "description": "When the comment was posted (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "postedUid": {
      -        "description": "The UID of the user who posted this comment.",
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "description": "The ID of the project this comment belongs to.",
      -        "type": "string"
      -      },
      -      "taskId": {
      -        "description": "The ID of the task this comment belongs to.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "postedAt"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "description": {
      -        "description": "The description of the section. Supports Markdown.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "description": "The unique ID of the section.",
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "The name of the section.",
      -        "type": "string"
      -      },
      -      "sectionOrder": {
      -        "description": "The ordering index of the section within its project.",
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name",
      -      "sectionOrder"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "addedAt": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "assignedByUid": {
      +        "type": "string"
      +      },
      +      "checked": {
      +        "description": "Whether the task is completed.",
      +        "type": "boolean"
      +      },
      +      "completedAt": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "content": {
      +        "description": "Task title.",
      +        "type": "string"
      +      },
      +      "deadlineDate": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "description": {
      +        "type": "string"
      +      },
      +      "dueDate": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "duration": {
      +        "description": "e.g. \"2h30m\".",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "isUncompletable": {
      +        "description": "An organizational header, not a real task.",
      +        "type": "boolean"
      +      },
      +      "labels": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "parentId": {
      +        "type": "string"
      +      },
      +      "priority": {
      +        "description": "p1 is highest, p4 lowest.",
      +        "enum": [
      +          "p1",
      +          "p2",
      +          "p3",
      +          "p4"
      +        ],
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "type": "string"
      +      },
      +      "recurring": {
      +        "anyOf": [
      +          {
      +            "type": "boolean"
      +          },
      +          {
      +            "type": "string"
      +          }
      +        ],
      +        "description": "False when not recurring, otherwise the recurrence string."
      +      },
      +      "responsibleUid": {
      +        "type": "string"
      +      },
      +      "sectionId": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "description",
      +      "recurring",
      +      "priority",
      +      "projectId",
      +      "checked"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "childOrder": {
      +        "description": "Ordering index among siblings.",
      +        "type": "number"
      +      },
      +      "color": {
      +        "enum": [
      +          "berry_red",
      +          "red",
      +          "orange",
      +          "yellow",
      +          "olive_green",
      +          "lime_green",
      +          "green",
      +          "mint_green",
      +          "teal",
      +          "sky_blue",
      +          "light_blue",
      +          "blue",
      +          "grape",
      +          "violet",
      +          "lavender",
      +          "magenta",
      +          "salmon",
      +          "charcoal",
      +          "grey",
      +          "taupe"
      +        ],
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "Empty string when none.",
      +        "type": "string"
      +      },
      +      "folderId": {
      +        "description": "Workspace projects only.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "inboxProject": {
      +        "type": "boolean"
      +      },
      +      "isArchived": {
      +        "type": "boolean"
      +      },
      +      "isFavorite": {
      +        "type": "boolean"
      +      },
      +      "isShared": {
      +        "type": "boolean"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "parentId": {
      +        "type": "string"
      +      },
      +      "viewStyle": {
      +        "description": "list, board or calendar.",
      +        "type": "string"
      +      },
      +      "workspaceId": {
      +        "description": "Undefined for personal projects.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "description",
      +      "isFavorite",
      +      "isShared",
      +      "inboxProject",
      +      "viewStyle",
      +      "childOrder",
      +      "isArchived"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "content": {
      +        "type": "string"
      +      },
      +      "fileAttachment": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "fileDuration": {
      +            "description": "Milliseconds, for audio/video.",
      +            "type": "number"
      +          },
      +          "fileName": {
      +            "type": "string"
      +          },
      +          "fileSize": {
      +            "description": "Bytes.",
      +            "type": "number"
      +          },
      +          "fileType": {
      +            "description": "MIME type.",
      +            "type": "string"
      +          },
      +          "fileUrl": {
      +            "type": "string"
      +          },
      +          "image": {
      +            "description": "For image resource types.",
      +            "type": "string"
      +          },
      +          "imageHeight": {
      +            "description": "Pixels.",
      +            "type": "number"
      +          },
      +          "imageWidth": {
      +            "description": "Pixels.",
      +            "type": "number"
      +          },
      +          "resourceType": {
      +            "description": "file, url, image, etc.",
      +            "type": "string"
      +          },
      +          "title": {
      +            "description": "For link/url resource types.",
      +            "type": "string"
      +          },
      +          "uploadState": {
      +            "enum": [
      +              "pending",
      +              "completed"
      +            ],
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "For link/url resource types.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "resourceType"
      +        ],
      +        "type": "object"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "postedAt": {
      +        "description": "ISO 8601.",
      +        "type": "string"
      +      },
      +      "postedUid": {
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "type": "string"
      +      },
      +      "taskId": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "postedAt"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "description": {
      +        "description": "Supports Markdown.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "sectionOrder": {
      +        "description": "Ordering index within the project.",
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "sectionOrder"
      +    ],
      +    "type": "object"
      +  }
      +]
  6. Changed5 schema fields changedv12.2.4
    • addedInput schema / properties / includeChildren
      Added value: +{
      +  "description": "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.",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / childCount
      Added value: +{
      +  "description": "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.",
      +  "type": "number"
      +}
    • addedOutput schema / properties / children
      Added value: +{
      +  "description": "Direct children only: subtasks for a task, sub-projects for a project. Completed subtasks and archived sub-projects are excluded.",
      +  "items": {
      +    "anyOf": [
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "checked": {
      +            "description": "Whether the task is checked/completed.",
      +            "type": "boolean"
      +          },
      +          "content": {
      +            "description": "The task title/content.",
      +            "type": "string"
      +          },
      +          "dueDate": {
      +            "description": "The due date of the task (ISO 8601 format).",
      +            "type": "string"
      +          },
      +          "hasChildren": {
      +            "description": "Whether this subtask has subtasks of its own. Fetch it with includeChildren to expand.",
      +            "type": "boolean"
      +          },
      +          "id": {
      +            "description": "The unique ID of the task.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "content",
      +          "checked",
      +          "hasChildren"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "hasChildren": {
      +            "description": "Whether this sub-project has sub-projects of its own. Fetch it with includeChildren to expand.",
      +            "type": "boolean"
      +          },
      +          "id": {
      +            "description": "The unique ID of the project.",
      +            "type": "string"
      +          },
      +          "name": {
      +            "description": "The name of the project.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "hasChildren"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / childrenError
      Added value: +{
      +  "description": "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\".",
      +  "type": "string"
      +}
    • addedOutput schema / properties / hasMoreChildren
      Added value: +{
      +  "description": "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.",
      +  "type": "boolean"
      +}
  7. Changed1 schema field changedv12.1.2
    • changedOutput schema / properties / object / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "addedAt": {
      -        "description": "When the task was created (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "assignedByUid": {
      -        "description": "The UID of the user who assigned this task.",
      -        "type": "string"
      -      },
      -      "checked": {
      -        "description": "Whether the task is checked/completed.",
      -        "type": "boolean"
      -      },
      -      "completedAt": {
      -        "description": "When the task was completed (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "content": {
      -        "description": "The task title/content.",
      -        "type": "string"
      -      },
      -      "deadlineDate": {
      -        "description": "The deadline date of the task (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "The task description.",
      -        "type": "string"
      -      },
      -      "dueDate": {
      -        "description": "The due date of the task (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "duration": {
      -        "description": "The duration of the task (e.g., \"2h30m\").",
      -        "type": "string"
      -      },
      -      "id": {
      -        "description": "The unique ID of the task.",
      -        "type": "string"
      -      },
      -      "isUncompletable": {
      -        "description": "Whether the task is uncompletable (organizational header).",
      -        "type": "boolean"
      -      },
      -      "labels": {
      -        "description": "The labels attached to this task.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "parentId": {
      -        "description": "The ID of the parent task (for subtasks).",
      -        "type": "string"
      -      },
      -      "priority": {
      -        "description": "The priority level: p1 (highest), p2 (high), p3 (medium), p4 (lowest).",
      -        "enum": [
      -          "p1",
      -          "p2",
      -          "p3",
      -          "p4"
      -        ],
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "description": "The ID of the project this task belongs to.",
      -        "type": "string"
      -      },
      -      "recurring": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "string"
      -          }
      -        ],
      -        "description": "Whether the task is recurring, or the recurrence string."
      -      },
      -      "responsibleUid": {
      -        "description": "The UID of the user responsible for this task.",
      -        "type": "string"
      -      },
      -      "sectionId": {
      -        "description": "The ID of the section this task belongs to.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "description",
      -      "recurring",
      -      "priority",
      -      "projectId",
      -      "checked"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "childOrder": {
      -        "description": "The ordering index of the project among its siblings.",
      -        "type": "number"
      -      },
      -      "color": {
      -        "description": "The color key of the entity.",
      -        "enum": [
      -          "berry_red",
      -          "red",
      -          "orange",
      -          "yellow",
      -          "olive_green",
      -          "lime_green",
      -          "green",
      -          "mint_green",
      -          "teal",
      -          "sky_blue",
      -          "light_blue",
      -          "blue",
      -          "grape",
      -          "violet",
      -          "lavender",
      -          "magenta",
      -          "salmon",
      -          "charcoal",
      -          "grey",
      -          "taupe"
      -        ],
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "The description of the project (empty string if none).",
      -        "type": "string"
      -      },
      -      "folderId": {
      -        "description": "The ID of the folder this project belongs to (workspace projects only).",
      -        "type": "string"
      -      },
      -      "id": {
      -        "description": "The unique ID of the project.",
      -        "type": "string"
      -      },
      -      "inboxProject": {
      -        "description": "Whether this is the inbox project.",
      -        "type": "boolean"
      -      },
      -      "isArchived": {
      -        "description": "Whether the project is archived.",
      -        "type": "boolean"
      -      },
      -      "isFavorite": {
      -        "description": "Whether the project is marked as favorite.",
      -        "type": "boolean"
      -      },
      -      "isShared": {
      -        "description": "Whether the project is shared.",
      -        "type": "boolean"
      -      },
      -      "name": {
      -        "description": "The name of the project.",
      -        "type": "string"
      -      },
      -      "parentId": {
      -        "description": "The ID of the parent project (for sub-projects).",
      -        "type": "string"
      -      },
      -      "viewStyle": {
      -        "description": "The view style of the project (list, board, calendar).",
      -        "type": "string"
      -      },
      -      "workspaceId": {
      -        "description": "The ID of the workspace this project belongs to (undefined for personal projects).",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name",
      -      "description",
      -      "isFavorite",
      -      "isShared",
      -      "inboxProject",
      -      "viewStyle",
      -      "childOrder",
      -      "isArchived"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "content": {
      -        "description": "The content of the comment.",
      -        "type": "string"
      -      },
      -      "fileAttachment": {
      -        "additionalProperties": false,
      -        "description": "File attachment information, if any.",
      -        "properties": {
      -          "fileDuration": {
      -            "description": "The duration in milliseconds (for audio/video files).",
      -            "type": "number"
      -          },
      -          "fileName": {
      -            "description": "The name of the file.",
      -            "type": "string"
      -          },
      -          "fileSize": {
      -            "description": "The size of the file in bytes.",
      -            "type": "number"
      -          },
      -          "fileType": {
      -            "description": "The MIME type of the file.",
      -            "type": "string"
      -          },
      -          "fileUrl": {
      -            "description": "The URL to access the file.",
      -            "type": "string"
      -          },
      -          "image": {
      -            "description": "The image URL for image resource types.",
      -            "type": "string"
      -          },
      -          "imageHeight": {
      -            "description": "The height of the image in pixels.",
      -            "type": "number"
      -          },
      -          "imageWidth": {
      -            "description": "The width of the image in pixels.",
      -            "type": "number"
      -          },
      -          "resourceType": {
      -            "description": "The type of resource (file, url, image, etc).",
      -            "type": "string"
      -          },
      -          "title": {
      -            "description": "The title for link/url resource types.",
      -            "type": "string"
      -          },
      -          "uploadState": {
      -            "description": "The upload state of the file.",
      -            "enum": [
      -              "pending",
      -              "completed"
      -            ],
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The URL for link/url resource types.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "resourceType"
      -        ],
      -        "type": "object"
      -      },
      -      "id": {
      -        "description": "The unique ID of the comment.",
      -        "type": "string"
      -      },
      -      "postedAt": {
      -        "description": "When the comment was posted (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "postedUid": {
      -        "description": "The UID of the user who posted this comment.",
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "description": "The ID of the project this comment belongs to.",
      -        "type": "string"
      -      },
      -      "taskId": {
      -        "description": "The ID of the task this comment belongs to.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "postedAt"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "description": {
      -        "description": "The description of the section. Supports Markdown.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "description": "The unique ID of the section.",
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "The name of the section.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "addedAt": {
      +        "description": "When the task was created (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "assignedByUid": {
      +        "description": "The UID of the user who assigned this task.",
      +        "type": "string"
      +      },
      +      "checked": {
      +        "description": "Whether the task is checked/completed.",
      +        "type": "boolean"
      +      },
      +      "completedAt": {
      +        "description": "When the task was completed (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "content": {
      +        "description": "The task title/content.",
      +        "type": "string"
      +      },
      +      "deadlineDate": {
      +        "description": "The deadline date of the task (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "The task description.",
      +        "type": "string"
      +      },
      +      "dueDate": {
      +        "description": "The due date of the task (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "duration": {
      +        "description": "The duration of the task (e.g., \"2h30m\").",
      +        "type": "string"
      +      },
      +      "id": {
      +        "description": "The unique ID of the task.",
      +        "type": "string"
      +      },
      +      "isUncompletable": {
      +        "description": "Whether the task is uncompletable (organizational header).",
      +        "type": "boolean"
      +      },
      +      "labels": {
      +        "description": "The labels attached to this task.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "parentId": {
      +        "description": "The ID of the parent task (for subtasks).",
      +        "type": "string"
      +      },
      +      "priority": {
      +        "description": "The priority level: p1 (highest), p2 (high), p3 (medium), p4 (lowest).",
      +        "enum": [
      +          "p1",
      +          "p2",
      +          "p3",
      +          "p4"
      +        ],
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "description": "The ID of the project this task belongs to.",
      +        "type": "string"
      +      },
      +      "recurring": {
      +        "anyOf": [
      +          {
      +            "type": "boolean"
      +          },
      +          {
      +            "type": "string"
      +          }
      +        ],
      +        "description": "Whether the task is recurring, or the recurrence string."
      +      },
      +      "responsibleUid": {
      +        "description": "The UID of the user responsible for this task.",
      +        "type": "string"
      +      },
      +      "sectionId": {
      +        "description": "The ID of the section this task belongs to.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "description",
      +      "recurring",
      +      "priority",
      +      "projectId",
      +      "checked"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "childOrder": {
      +        "description": "The ordering index of the project among its siblings.",
      +        "type": "number"
      +      },
      +      "color": {
      +        "description": "The color key of the entity.",
      +        "enum": [
      +          "berry_red",
      +          "red",
      +          "orange",
      +          "yellow",
      +          "olive_green",
      +          "lime_green",
      +          "green",
      +          "mint_green",
      +          "teal",
      +          "sky_blue",
      +          "light_blue",
      +          "blue",
      +          "grape",
      +          "violet",
      +          "lavender",
      +          "magenta",
      +          "salmon",
      +          "charcoal",
      +          "grey",
      +          "taupe"
      +        ],
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "The description of the project (empty string if none).",
      +        "type": "string"
      +      },
      +      "folderId": {
      +        "description": "The ID of the folder this project belongs to (workspace projects only).",
      +        "type": "string"
      +      },
      +      "id": {
      +        "description": "The unique ID of the project.",
      +        "type": "string"
      +      },
      +      "inboxProject": {
      +        "description": "Whether this is the inbox project.",
      +        "type": "boolean"
      +      },
      +      "isArchived": {
      +        "description": "Whether the project is archived.",
      +        "type": "boolean"
      +      },
      +      "isFavorite": {
      +        "description": "Whether the project is marked as favorite.",
      +        "type": "boolean"
      +      },
      +      "isShared": {
      +        "description": "Whether the project is shared.",
      +        "type": "boolean"
      +      },
      +      "name": {
      +        "description": "The name of the project.",
      +        "type": "string"
      +      },
      +      "parentId": {
      +        "description": "The ID of the parent project (for sub-projects).",
      +        "type": "string"
      +      },
      +      "viewStyle": {
      +        "description": "The view style of the project (list, board, calendar).",
      +        "type": "string"
      +      },
      +      "workspaceId": {
      +        "description": "The ID of the workspace this project belongs to (undefined for personal projects).",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "description",
      +      "isFavorite",
      +      "isShared",
      +      "inboxProject",
      +      "viewStyle",
      +      "childOrder",
      +      "isArchived"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "content": {
      +        "description": "The content of the comment.",
      +        "type": "string"
      +      },
      +      "fileAttachment": {
      +        "additionalProperties": false,
      +        "description": "File attachment information, if any.",
      +        "properties": {
      +          "fileDuration": {
      +            "description": "The duration in milliseconds (for audio/video files).",
      +            "type": "number"
      +          },
      +          "fileName": {
      +            "description": "The name of the file.",
      +            "type": "string"
      +          },
      +          "fileSize": {
      +            "description": "The size of the file in bytes.",
      +            "type": "number"
      +          },
      +          "fileType": {
      +            "description": "The MIME type of the file.",
      +            "type": "string"
      +          },
      +          "fileUrl": {
      +            "description": "The URL to access the file.",
      +            "type": "string"
      +          },
      +          "image": {
      +            "description": "The image URL for image resource types.",
      +            "type": "string"
      +          },
      +          "imageHeight": {
      +            "description": "The height of the image in pixels.",
      +            "type": "number"
      +          },
      +          "imageWidth": {
      +            "description": "The width of the image in pixels.",
      +            "type": "number"
      +          },
      +          "resourceType": {
      +            "description": "The type of resource (file, url, image, etc).",
      +            "type": "string"
      +          },
      +          "title": {
      +            "description": "The title for link/url resource types.",
      +            "type": "string"
      +          },
      +          "uploadState": {
      +            "description": "The upload state of the file.",
      +            "enum": [
      +              "pending",
      +              "completed"
      +            ],
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The URL for link/url resource types.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "resourceType"
      +        ],
      +        "type": "object"
      +      },
      +      "id": {
      +        "description": "The unique ID of the comment.",
      +        "type": "string"
      +      },
      +      "postedAt": {
      +        "description": "When the comment was posted (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "postedUid": {
      +        "description": "The UID of the user who posted this comment.",
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "description": "The ID of the project this comment belongs to.",
      +        "type": "string"
      +      },
      +      "taskId": {
      +        "description": "The ID of the task this comment belongs to.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "postedAt"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "description": {
      +        "description": "The description of the section. Supports Markdown.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "description": "The unique ID of the section.",
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "The name of the section.",
      +        "type": "string"
      +      },
      +      "sectionOrder": {
      +        "description": "The ordering index of the section within its project.",
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "sectionOrder"
      +    ],
      +    "type": "object"
      +  }
      +]
  8. Changed3 schema fields changedv12.0.0
    • changedInput schema / properties / type / enum
      Previous value: -[
      -  "task",
      -  "project",
      -  "comment",
      -  "section",
      -  "goal"
      -]New value: +[
      +  "task",
      +  "project",
      +  "comment",
      +  "section"
      +]
    • changedOutput schema / properties / object / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "addedAt": {
      -        "description": "When the task was created (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "assignedByUid": {
      -        "description": "The UID of the user who assigned this task.",
      -        "type": "string"
      -      },
      -      "checked": {
      -        "description": "Whether the task is checked/completed.",
      -        "type": "boolean"
      -      },
      -      "completedAt": {
      -        "description": "When the task was completed (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "content": {
      -        "description": "The task title/content.",
      -        "type": "string"
      -      },
      -      "deadlineDate": {
      -        "description": "The deadline date of the task (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "The task description.",
      -        "type": "string"
      -      },
      -      "dueDate": {
      -        "description": "The due date of the task (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "duration": {
      -        "description": "The duration of the task (e.g., \"2h30m\").",
      -        "type": "string"
      -      },
      -      "id": {
      -        "description": "The unique ID of the task.",
      -        "type": "string"
      -      },
      -      "isUncompletable": {
      -        "description": "Whether the task is uncompletable (organizational header).",
      -        "type": "boolean"
      -      },
      -      "labels": {
      -        "description": "The labels attached to this task.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "parentId": {
      -        "description": "The ID of the parent task (for subtasks).",
      -        "type": "string"
      -      },
      -      "priority": {
      -        "description": "The priority level: p1 (highest), p2 (high), p3 (medium), p4 (lowest).",
      -        "enum": [
      -          "p1",
      -          "p2",
      -          "p3",
      -          "p4"
      -        ],
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "description": "The ID of the project this task belongs to.",
      -        "type": "string"
      -      },
      -      "recurring": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "string"
      -          }
      -        ],
      -        "description": "Whether the task is recurring, or the recurrence string."
      -      },
      -      "responsibleUid": {
      -        "description": "The UID of the user responsible for this task.",
      -        "type": "string"
      -      },
      -      "sectionId": {
      -        "description": "The ID of the section this task belongs to.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "description",
      -      "recurring",
      -      "priority",
      -      "projectId",
      -      "checked"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "childOrder": {
      -        "description": "The ordering index of the project among its siblings.",
      -        "type": "number"
      -      },
      -      "color": {
      -        "description": "The color key of the entity.",
      -        "enum": [
      -          "berry_red",
      -          "red",
      -          "orange",
      -          "yellow",
      -          "olive_green",
      -          "lime_green",
      -          "green",
      -          "mint_green",
      -          "teal",
      -          "sky_blue",
      -          "light_blue",
      -          "blue",
      -          "grape",
      -          "violet",
      -          "lavender",
      -          "magenta",
      -          "salmon",
      -          "charcoal",
      -          "grey",
      -          "taupe"
      -        ],
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "The description of the project (empty string if none).",
      -        "type": "string"
      -      },
      -      "folderId": {
      -        "description": "The ID of the folder this project belongs to (workspace projects only).",
      -        "type": "string"
      -      },
      -      "id": {
      -        "description": "The unique ID of the project.",
      -        "type": "string"
      -      },
      -      "inboxProject": {
      -        "description": "Whether this is the inbox project.",
      -        "type": "boolean"
      -      },
      -      "isArchived": {
      -        "description": "Whether the project is archived.",
      -        "type": "boolean"
      -      },
      -      "isFavorite": {
      -        "description": "Whether the project is marked as favorite.",
      -        "type": "boolean"
      -      },
      -      "isShared": {
      -        "description": "Whether the project is shared.",
      -        "type": "boolean"
      -      },
      -      "name": {
      -        "description": "The name of the project.",
      -        "type": "string"
      -      },
      -      "parentId": {
      -        "description": "The ID of the parent project (for sub-projects).",
      -        "type": "string"
      -      },
      -      "viewStyle": {
      -        "description": "The view style of the project (list, board, calendar).",
      -        "type": "string"
      -      },
      -      "workspaceId": {
      -        "description": "The ID of the workspace this project belongs to (undefined for personal projects).",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name",
      -      "description",
      -      "isFavorite",
      -      "isShared",
      -      "inboxProject",
      -      "viewStyle",
      -      "childOrder",
      -      "isArchived"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "content": {
      -        "description": "The content of the comment.",
      -        "type": "string"
      -      },
      -      "fileAttachment": {
      -        "additionalProperties": false,
      -        "description": "File attachment information, if any.",
      -        "properties": {
      -          "fileDuration": {
      -            "description": "The duration in milliseconds (for audio/video files).",
      -            "type": "number"
      -          },
      -          "fileName": {
      -            "description": "The name of the file.",
      -            "type": "string"
      -          },
      -          "fileSize": {
      -            "description": "The size of the file in bytes.",
      -            "type": "number"
      -          },
      -          "fileType": {
      -            "description": "The MIME type of the file.",
      -            "type": "string"
      -          },
      -          "fileUrl": {
      -            "description": "The URL to access the file.",
      -            "type": "string"
      -          },
      -          "image": {
      -            "description": "The image URL for image resource types.",
      -            "type": "string"
      -          },
      -          "imageHeight": {
      -            "description": "The height of the image in pixels.",
      -            "type": "number"
      -          },
      -          "imageWidth": {
      -            "description": "The width of the image in pixels.",
      -            "type": "number"
      -          },
      -          "resourceType": {
      -            "description": "The type of resource (file, url, image, etc).",
      -            "type": "string"
      -          },
      -          "title": {
      -            "description": "The title for link/url resource types.",
      -            "type": "string"
      -          },
      -          "uploadState": {
      -            "description": "The upload state of the file.",
      -            "enum": [
      -              "pending",
      -              "completed"
      -            ],
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The URL for link/url resource types.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "resourceType"
      -        ],
      -        "type": "object"
      -      },
      -      "id": {
      -        "description": "The unique ID of the comment.",
      -        "type": "string"
      -      },
      -      "postedAt": {
      -        "description": "When the comment was posted (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "postedUid": {
      -        "description": "The UID of the user who posted this comment.",
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "description": "The ID of the project this comment belongs to.",
      -        "type": "string"
      -      },
      -      "taskId": {
      -        "description": "The ID of the task this comment belongs to.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "postedAt"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "description": {
      -        "description": "The description of the section. Supports Markdown.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "description": "The unique ID of the section.",
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "The name of the section.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "deadline": {
      -        "description": "The deadline (YYYY-MM-DD).",
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "The description of the goal.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "description": "The unique ID of the goal.",
      -        "type": "string"
      -      },
      -      "isCompleted": {
      -        "description": "Whether the goal is completed.",
      -        "type": "boolean"
      -      },
      -      "name": {
      -        "description": "The name of the goal.",
      -        "type": "string"
      -      },
      -      "ownerId": {
      -        "description": "The owner ID (user ID or workspace ID).",
      -        "type": "string"
      -      },
      -      "ownerType": {
      -        "description": "The owner type: USER or WORKSPACE.",
      -        "type": "string"
      -      },
      -      "progress": {
      -        "additionalProperties": false,
      -        "description": "Progress of linked tasks.",
      -        "properties": {
      -          "completedTaskCount": {
      -            "type": "number"
      -          },
      -          "percentage": {
      -            "type": "number"
      -          },
      -          "totalTaskCount": {
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "totalTaskCount",
      -          "completedTaskCount",
      -          "percentage"
      -        ],
      -        "type": "object"
      -      },
      -      "responsibleUid": {
      -        "description": "The user ID responsible for this goal.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name",
      -      "ownerType",
      -      "ownerId",
      -      "isCompleted"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "addedAt": {
      +        "description": "When the task was created (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "assignedByUid": {
      +        "description": "The UID of the user who assigned this task.",
      +        "type": "string"
      +      },
      +      "checked": {
      +        "description": "Whether the task is checked/completed.",
      +        "type": "boolean"
      +      },
      +      "completedAt": {
      +        "description": "When the task was completed (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "content": {
      +        "description": "The task title/content.",
      +        "type": "string"
      +      },
      +      "deadlineDate": {
      +        "description": "The deadline date of the task (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "The task description.",
      +        "type": "string"
      +      },
      +      "dueDate": {
      +        "description": "The due date of the task (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "duration": {
      +        "description": "The duration of the task (e.g., \"2h30m\").",
      +        "type": "string"
      +      },
      +      "id": {
      +        "description": "The unique ID of the task.",
      +        "type": "string"
      +      },
      +      "isUncompletable": {
      +        "description": "Whether the task is uncompletable (organizational header).",
      +        "type": "boolean"
      +      },
      +      "labels": {
      +        "description": "The labels attached to this task.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "parentId": {
      +        "description": "The ID of the parent task (for subtasks).",
      +        "type": "string"
      +      },
      +      "priority": {
      +        "description": "The priority level: p1 (highest), p2 (high), p3 (medium), p4 (lowest).",
      +        "enum": [
      +          "p1",
      +          "p2",
      +          "p3",
      +          "p4"
      +        ],
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "description": "The ID of the project this task belongs to.",
      +        "type": "string"
      +      },
      +      "recurring": {
      +        "anyOf": [
      +          {
      +            "type": "boolean"
      +          },
      +          {
      +            "type": "string"
      +          }
      +        ],
      +        "description": "Whether the task is recurring, or the recurrence string."
      +      },
      +      "responsibleUid": {
      +        "description": "The UID of the user responsible for this task.",
      +        "type": "string"
      +      },
      +      "sectionId": {
      +        "description": "The ID of the section this task belongs to.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "description",
      +      "recurring",
      +      "priority",
      +      "projectId",
      +      "checked"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "childOrder": {
      +        "description": "The ordering index of the project among its siblings.",
      +        "type": "number"
      +      },
      +      "color": {
      +        "description": "The color key of the entity.",
      +        "enum": [
      +          "berry_red",
      +          "red",
      +          "orange",
      +          "yellow",
      +          "olive_green",
      +          "lime_green",
      +          "green",
      +          "mint_green",
      +          "teal",
      +          "sky_blue",
      +          "light_blue",
      +          "blue",
      +          "grape",
      +          "violet",
      +          "lavender",
      +          "magenta",
      +          "salmon",
      +          "charcoal",
      +          "grey",
      +          "taupe"
      +        ],
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "The description of the project (empty string if none).",
      +        "type": "string"
      +      },
      +      "folderId": {
      +        "description": "The ID of the folder this project belongs to (workspace projects only).",
      +        "type": "string"
      +      },
      +      "id": {
      +        "description": "The unique ID of the project.",
      +        "type": "string"
      +      },
      +      "inboxProject": {
      +        "description": "Whether this is the inbox project.",
      +        "type": "boolean"
      +      },
      +      "isArchived": {
      +        "description": "Whether the project is archived.",
      +        "type": "boolean"
      +      },
      +      "isFavorite": {
      +        "description": "Whether the project is marked as favorite.",
      +        "type": "boolean"
      +      },
      +      "isShared": {
      +        "description": "Whether the project is shared.",
      +        "type": "boolean"
      +      },
      +      "name": {
      +        "description": "The name of the project.",
      +        "type": "string"
      +      },
      +      "parentId": {
      +        "description": "The ID of the parent project (for sub-projects).",
      +        "type": "string"
      +      },
      +      "viewStyle": {
      +        "description": "The view style of the project (list, board, calendar).",
      +        "type": "string"
      +      },
      +      "workspaceId": {
      +        "description": "The ID of the workspace this project belongs to (undefined for personal projects).",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "description",
      +      "isFavorite",
      +      "isShared",
      +      "inboxProject",
      +      "viewStyle",
      +      "childOrder",
      +      "isArchived"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "content": {
      +        "description": "The content of the comment.",
      +        "type": "string"
      +      },
      +      "fileAttachment": {
      +        "additionalProperties": false,
      +        "description": "File attachment information, if any.",
      +        "properties": {
      +          "fileDuration": {
      +            "description": "The duration in milliseconds (for audio/video files).",
      +            "type": "number"
      +          },
      +          "fileName": {
      +            "description": "The name of the file.",
      +            "type": "string"
      +          },
      +          "fileSize": {
      +            "description": "The size of the file in bytes.",
      +            "type": "number"
      +          },
      +          "fileType": {
      +            "description": "The MIME type of the file.",
      +            "type": "string"
      +          },
      +          "fileUrl": {
      +            "description": "The URL to access the file.",
      +            "type": "string"
      +          },
      +          "image": {
      +            "description": "The image URL for image resource types.",
      +            "type": "string"
      +          },
      +          "imageHeight": {
      +            "description": "The height of the image in pixels.",
      +            "type": "number"
      +          },
      +          "imageWidth": {
      +            "description": "The width of the image in pixels.",
      +            "type": "number"
      +          },
      +          "resourceType": {
      +            "description": "The type of resource (file, url, image, etc).",
      +            "type": "string"
      +          },
      +          "title": {
      +            "description": "The title for link/url resource types.",
      +            "type": "string"
      +          },
      +          "uploadState": {
      +            "description": "The upload state of the file.",
      +            "enum": [
      +              "pending",
      +              "completed"
      +            ],
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The URL for link/url resource types.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "resourceType"
      +        ],
      +        "type": "object"
      +      },
      +      "id": {
      +        "description": "The unique ID of the comment.",
      +        "type": "string"
      +      },
      +      "postedAt": {
      +        "description": "When the comment was posted (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "postedUid": {
      +        "description": "The UID of the user who posted this comment.",
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "description": "The ID of the project this comment belongs to.",
      +        "type": "string"
      +      },
      +      "taskId": {
      +        "description": "The ID of the task this comment belongs to.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "postedAt"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "description": {
      +        "description": "The description of the section. Supports Markdown.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "description": "The unique ID of the section.",
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "The name of the section.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedOutput schema / properties / type / enum
      Previous value: -[
      -  "task",
      -  "project",
      -  "comment",
      -  "section",
      -  "goal"
      -]New value: +[
      +  "task",
      +  "project",
      +  "comment",
      +  "section"
      +]
  9. Changed1 schema field changedv10.5.0
    • changedOutput schema / properties / object / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "assignedByUid": {
      -        "description": "The UID of the user who assigned this task.",
      -        "type": "string"
      -      },
      -      "checked": {
      -        "description": "Whether the task is checked/completed.",
      -        "type": "boolean"
      -      },
      -      "completedAt": {
      -        "description": "When the task was completed (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "content": {
      -        "description": "The task title/content.",
      -        "type": "string"
      -      },
      -      "deadlineDate": {
      -        "description": "The deadline date of the task (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "The task description.",
      -        "type": "string"
      -      },
      -      "dueDate": {
      -        "description": "The due date of the task (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "duration": {
      -        "description": "The duration of the task (e.g., \"2h30m\").",
      -        "type": "string"
      -      },
      -      "id": {
      -        "description": "The unique ID of the task.",
      -        "type": "string"
      -      },
      -      "isUncompletable": {
      -        "description": "Whether the task is uncompletable (organizational header).",
      -        "type": "boolean"
      -      },
      -      "labels": {
      -        "description": "The labels attached to this task.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "parentId": {
      -        "description": "The ID of the parent task (for subtasks).",
      -        "type": "string"
      -      },
      -      "priority": {
      -        "description": "The priority level: p1 (highest), p2 (high), p3 (medium), p4 (lowest).",
      -        "enum": [
      -          "p1",
      -          "p2",
      -          "p3",
      -          "p4"
      -        ],
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "description": "The ID of the project this task belongs to.",
      -        "type": "string"
      -      },
      -      "recurring": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "string"
      -          }
      -        ],
      -        "description": "Whether the task is recurring, or the recurrence string."
      -      },
      -      "responsibleUid": {
      -        "description": "The UID of the user responsible for this task.",
      -        "type": "string"
      -      },
      -      "sectionId": {
      -        "description": "The ID of the section this task belongs to.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "description",
      -      "recurring",
      -      "priority",
      -      "projectId",
      -      "checked"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "childOrder": {
      -        "description": "The ordering index of the project among its siblings.",
      -        "type": "number"
      -      },
      -      "color": {
      -        "description": "The color key of the entity.",
      -        "enum": [
      -          "berry_red",
      -          "red",
      -          "orange",
      -          "yellow",
      -          "olive_green",
      -          "lime_green",
      -          "green",
      -          "mint_green",
      -          "teal",
      -          "sky_blue",
      -          "light_blue",
      -          "blue",
      -          "grape",
      -          "violet",
      -          "lavender",
      -          "magenta",
      -          "salmon",
      -          "charcoal",
      -          "grey",
      -          "taupe"
      -        ],
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "The description of the project (empty string if none).",
      -        "type": "string"
      -      },
      -      "folderId": {
      -        "description": "The ID of the folder this project belongs to (workspace projects only).",
      -        "type": "string"
      -      },
      -      "id": {
      -        "description": "The unique ID of the project.",
      -        "type": "string"
      -      },
      -      "inboxProject": {
      -        "description": "Whether this is the inbox project.",
      -        "type": "boolean"
      -      },
      -      "isArchived": {
      -        "description": "Whether the project is archived.",
      -        "type": "boolean"
      -      },
      -      "isFavorite": {
      -        "description": "Whether the project is marked as favorite.",
      -        "type": "boolean"
      -      },
      -      "isShared": {
      -        "description": "Whether the project is shared.",
      -        "type": "boolean"
      -      },
      -      "name": {
      -        "description": "The name of the project.",
      -        "type": "string"
      -      },
      -      "parentId": {
      -        "description": "The ID of the parent project (for sub-projects).",
      -        "type": "string"
      -      },
      -      "viewStyle": {
      -        "description": "The view style of the project (list, board, calendar).",
      -        "type": "string"
      -      },
      -      "workspaceId": {
      -        "description": "The ID of the workspace this project belongs to (undefined for personal projects).",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name",
      -      "description",
      -      "isFavorite",
      -      "isShared",
      -      "inboxProject",
      -      "viewStyle",
      -      "childOrder",
      -      "isArchived"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "content": {
      -        "description": "The content of the comment.",
      -        "type": "string"
      -      },
      -      "fileAttachment": {
      -        "additionalProperties": false,
      -        "description": "File attachment information, if any.",
      -        "properties": {
      -          "fileDuration": {
      -            "description": "The duration in milliseconds (for audio/video files).",
      -            "type": "number"
      -          },
      -          "fileName": {
      -            "description": "The name of the file.",
      -            "type": "string"
      -          },
      -          "fileSize": {
      -            "description": "The size of the file in bytes.",
      -            "type": "number"
      -          },
      -          "fileType": {
      -            "description": "The MIME type of the file.",
      -            "type": "string"
      -          },
      -          "fileUrl": {
      -            "description": "The URL to access the file.",
      -            "type": "string"
      -          },
      -          "image": {
      -            "description": "The image URL for image resource types.",
      -            "type": "string"
      -          },
      -          "imageHeight": {
      -            "description": "The height of the image in pixels.",
      -            "type": "number"
      -          },
      -          "imageWidth": {
      -            "description": "The width of the image in pixels.",
      -            "type": "number"
      -          },
      -          "resourceType": {
      -            "description": "The type of resource (file, url, image, etc).",
      -            "type": "string"
      -          },
      -          "title": {
      -            "description": "The title for link/url resource types.",
      -            "type": "string"
      -          },
      -          "uploadState": {
      -            "description": "The upload state of the file.",
      -            "enum": [
      -              "pending",
      -              "completed"
      -            ],
      -            "type": "string"
      -          },
      -          "url": {
      -            "description": "The URL for link/url resource types.",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "resourceType"
      -        ],
      -        "type": "object"
      -      },
      -      "id": {
      -        "description": "The unique ID of the comment.",
      -        "type": "string"
      -      },
      -      "postedAt": {
      -        "description": "When the comment was posted (ISO 8601 format).",
      -        "type": "string"
      -      },
      -      "postedUid": {
      -        "description": "The UID of the user who posted this comment.",
      -        "type": "string"
      -      },
      -      "projectId": {
      -        "description": "The ID of the project this comment belongs to.",
      -        "type": "string"
      -      },
      -      "taskId": {
      -        "description": "The ID of the task this comment belongs to.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "content",
      -      "postedAt"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "description": {
      -        "description": "The description of the section. Supports Markdown.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "description": "The unique ID of the section.",
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "The name of the section.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "deadline": {
      -        "description": "The deadline (YYYY-MM-DD).",
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "The description of the goal.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "description": "The unique ID of the goal.",
      -        "type": "string"
      -      },
      -      "isCompleted": {
      -        "description": "Whether the goal is completed.",
      -        "type": "boolean"
      -      },
      -      "name": {
      -        "description": "The name of the goal.",
      -        "type": "string"
      -      },
      -      "ownerId": {
      -        "description": "The owner ID (user ID or workspace ID).",
      -        "type": "string"
      -      },
      -      "ownerType": {
      -        "description": "The owner type: USER or WORKSPACE.",
      -        "type": "string"
      -      },
      -      "progress": {
      -        "additionalProperties": false,
      -        "description": "Progress of linked tasks.",
      -        "properties": {
      -          "completedTaskCount": {
      -            "type": "number"
      -          },
      -          "percentage": {
      -            "type": "number"
      -          },
      -          "totalTaskCount": {
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "totalTaskCount",
      -          "completedTaskCount",
      -          "percentage"
      -        ],
      -        "type": "object"
      -      },
      -      "responsibleUid": {
      -        "description": "The user ID responsible for this goal.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "name",
      -      "ownerType",
      -      "ownerId",
      -      "isCompleted"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "addedAt": {
      +        "description": "When the task was created (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "assignedByUid": {
      +        "description": "The UID of the user who assigned this task.",
      +        "type": "string"
      +      },
      +      "checked": {
      +        "description": "Whether the task is checked/completed.",
      +        "type": "boolean"
      +      },
      +      "completedAt": {
      +        "description": "When the task was completed (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "content": {
      +        "description": "The task title/content.",
      +        "type": "string"
      +      },
      +      "deadlineDate": {
      +        "description": "The deadline date of the task (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "The task description.",
      +        "type": "string"
      +      },
      +      "dueDate": {
      +        "description": "The due date of the task (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "duration": {
      +        "description": "The duration of the task (e.g., \"2h30m\").",
      +        "type": "string"
      +      },
      +      "id": {
      +        "description": "The unique ID of the task.",
      +        "type": "string"
      +      },
      +      "isUncompletable": {
      +        "description": "Whether the task is uncompletable (organizational header).",
      +        "type": "boolean"
      +      },
      +      "labels": {
      +        "description": "The labels attached to this task.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "parentId": {
      +        "description": "The ID of the parent task (for subtasks).",
      +        "type": "string"
      +      },
      +      "priority": {
      +        "description": "The priority level: p1 (highest), p2 (high), p3 (medium), p4 (lowest).",
      +        "enum": [
      +          "p1",
      +          "p2",
      +          "p3",
      +          "p4"
      +        ],
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "description": "The ID of the project this task belongs to.",
      +        "type": "string"
      +      },
      +      "recurring": {
      +        "anyOf": [
      +          {
      +            "type": "boolean"
      +          },
      +          {
      +            "type": "string"
      +          }
      +        ],
      +        "description": "Whether the task is recurring, or the recurrence string."
      +      },
      +      "responsibleUid": {
      +        "description": "The UID of the user responsible for this task.",
      +        "type": "string"
      +      },
      +      "sectionId": {
      +        "description": "The ID of the section this task belongs to.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "description",
      +      "recurring",
      +      "priority",
      +      "projectId",
      +      "checked"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "childOrder": {
      +        "description": "The ordering index of the project among its siblings.",
      +        "type": "number"
      +      },
      +      "color": {
      +        "description": "The color key of the entity.",
      +        "enum": [
      +          "berry_red",
      +          "red",
      +          "orange",
      +          "yellow",
      +          "olive_green",
      +          "lime_green",
      +          "green",
      +          "mint_green",
      +          "teal",
      +          "sky_blue",
      +          "light_blue",
      +          "blue",
      +          "grape",
      +          "violet",
      +          "lavender",
      +          "magenta",
      +          "salmon",
      +          "charcoal",
      +          "grey",
      +          "taupe"
      +        ],
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "The description of the project (empty string if none).",
      +        "type": "string"
      +      },
      +      "folderId": {
      +        "description": "The ID of the folder this project belongs to (workspace projects only).",
      +        "type": "string"
      +      },
      +      "id": {
      +        "description": "The unique ID of the project.",
      +        "type": "string"
      +      },
      +      "inboxProject": {
      +        "description": "Whether this is the inbox project.",
      +        "type": "boolean"
      +      },
      +      "isArchived": {
      +        "description": "Whether the project is archived.",
      +        "type": "boolean"
      +      },
      +      "isFavorite": {
      +        "description": "Whether the project is marked as favorite.",
      +        "type": "boolean"
      +      },
      +      "isShared": {
      +        "description": "Whether the project is shared.",
      +        "type": "boolean"
      +      },
      +      "name": {
      +        "description": "The name of the project.",
      +        "type": "string"
      +      },
      +      "parentId": {
      +        "description": "The ID of the parent project (for sub-projects).",
      +        "type": "string"
      +      },
      +      "viewStyle": {
      +        "description": "The view style of the project (list, board, calendar).",
      +        "type": "string"
      +      },
      +      "workspaceId": {
      +        "description": "The ID of the workspace this project belongs to (undefined for personal projects).",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "description",
      +      "isFavorite",
      +      "isShared",
      +      "inboxProject",
      +      "viewStyle",
      +      "childOrder",
      +      "isArchived"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "content": {
      +        "description": "The content of the comment.",
      +        "type": "string"
      +      },
      +      "fileAttachment": {
      +        "additionalProperties": false,
      +        "description": "File attachment information, if any.",
      +        "properties": {
      +          "fileDuration": {
      +            "description": "The duration in milliseconds (for audio/video files).",
      +            "type": "number"
      +          },
      +          "fileName": {
      +            "description": "The name of the file.",
      +            "type": "string"
      +          },
      +          "fileSize": {
      +            "description": "The size of the file in bytes.",
      +            "type": "number"
      +          },
      +          "fileType": {
      +            "description": "The MIME type of the file.",
      +            "type": "string"
      +          },
      +          "fileUrl": {
      +            "description": "The URL to access the file.",
      +            "type": "string"
      +          },
      +          "image": {
      +            "description": "The image URL for image resource types.",
      +            "type": "string"
      +          },
      +          "imageHeight": {
      +            "description": "The height of the image in pixels.",
      +            "type": "number"
      +          },
      +          "imageWidth": {
      +            "description": "The width of the image in pixels.",
      +            "type": "number"
      +          },
      +          "resourceType": {
      +            "description": "The type of resource (file, url, image, etc).",
      +            "type": "string"
      +          },
      +          "title": {
      +            "description": "The title for link/url resource types.",
      +            "type": "string"
      +          },
      +          "uploadState": {
      +            "description": "The upload state of the file.",
      +            "enum": [
      +              "pending",
      +              "completed"
      +            ],
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "The URL for link/url resource types.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "resourceType"
      +        ],
      +        "type": "object"
      +      },
      +      "id": {
      +        "description": "The unique ID of the comment.",
      +        "type": "string"
      +      },
      +      "postedAt": {
      +        "description": "When the comment was posted (ISO 8601 format).",
      +        "type": "string"
      +      },
      +      "postedUid": {
      +        "description": "The UID of the user who posted this comment.",
      +        "type": "string"
      +      },
      +      "projectId": {
      +        "description": "The ID of the project this comment belongs to.",
      +        "type": "string"
      +      },
      +      "taskId": {
      +        "description": "The ID of the task this comment belongs to.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "content",
      +      "postedAt"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "description": {
      +        "description": "The description of the section. Supports Markdown.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "description": "The unique ID of the section.",
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "The name of the section.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "deadline": {
      +        "description": "The deadline (YYYY-MM-DD).",
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "The description of the goal.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "description": "The unique ID of the goal.",
      +        "type": "string"
      +      },
      +      "isCompleted": {
      +        "description": "Whether the goal is completed.",
      +        "type": "boolean"
      +      },
      +      "name": {
      +        "description": "The name of the goal.",
      +        "type": "string"
      +      },
      +      "ownerId": {
      +        "description": "The owner ID (user ID or workspace ID).",
      +        "type": "string"
      +      },
      +      "ownerType": {
      +        "description": "The owner type: USER or WORKSPACE.",
      +        "type": "string"
      +      },
      +      "progress": {
      +        "additionalProperties": false,
      +        "description": "Progress of linked tasks.",
      +        "properties": {
      +          "completedTaskCount": {
      +            "type": "number"
      +          },
      +          "percentage": {
      +            "type": "number"
      +          },
      +          "totalTaskCount": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "totalTaskCount",
      +          "completedTaskCount",
      +          "percentage"
      +        ],
      +        "type": "object"
      +      },
      +      "responsibleUid": {
      +        "description": "The user ID responsible for this goal.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "ownerType",
      +      "ownerId",
      +      "isCompleted"
      +    ],
      +    "type": "object"
      +  }
      +]
  10. First observedv10.4.2

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint, so the safety profile is covered. The description adds useful behavioral context by noting that includeChildren retrieves direct subtasks or sub-projects, which goes beyond the basic annotations. No contradiction with annotations exists.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is three short sentences with no filler. It front-loads the core action, immediately provides the usage context, and then covers the optional parameter. Every sentence earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is complete for a read-only single-object fetch tool. Combined with rich schema descriptions, annotations, and an output schema, an agent has everything needed to select and invoke the tool correctly without ambiguity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already fully documents id, type, and includeChildren. The description reinforces the parameter usage with 'by its ID' and 'direct subtasks or sub-projects,' but it does not add meaning substantially beyond the schema's existing parameter descriptions. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Fetch') and names the exact resources ('task, project, comment, or section') plus the key selector ('by its ID'). It clearly distinguishes this single-object fetch tool from sibling find/search tools by emphasizing the need for a specific object ID.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly states when to use the tool: 'Use this when you have a specific object ID and want to retrieve its full details.' It does not explicitly name alternatives or exclusions, but the context is clear enough for an agent to route to this tool instead of a find/search tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.