Comments

List, create, update, and delete comments on a task (including one-level replies). Deleted comments are omitted from listings. Comment text uses TipTap body — see TipTap documentation.

📄️Get Task Comments

Pages comments on a task. Deleted comments are omitted. Replies are returned as sibling rows in `comments` with `parentCommentId` set — there is no nested `replies` array. `skip` must be a multiple of `limit`. `total` counts top-level comments only.

📄️Create Comment

Creates a top-level comment or a one-level reply (`parentCommentId`). Field is TipTap `body` — see [TipTap documentation](https://tiptap.dev/docs/editor/introduction). Sanitised to a published allowlist before storage. Response: `{ 'comment': { … } }`.

📄️Update A Comment

Updates TipTap `body` and, when sent, `mentionedUserIds` — see [TipTap documentation](https://tiptap.dev/docs/editor/introduction). **403** unless the caller is the comment author. Response: `{ 'comment': { … } }`.

📄️Delete A Comment

Deletes a comment. Deleted comments do not appear in Get Task Comments. Response: `{ 'success': true }` (no `id`). **403** unless the caller is the comment author.