Skip to content

Comment

List comments on a task (all comments — top-level and replies — by default). Requires workspace context (–workspace-id or NWEB_WORKSPACE_ID). –task is the task ID (mapped to the task NRN). Pass –parent-comment-id to list only the replies under a specific comment. –created-by filters by author user NRN (repeatable, format: nweb:auth:user:, obtainable from retask auth whoami user_nrn). –sort: default, created-asc, created-desc

Flags: --task, --parent-comment-id, --sort, --created-by

Terminal window
retask comment list --task <task-id>

Get a comment by ID

Terminal window
retask comment get <comment-id>

Create a comment on a task. Requires workspace context (–workspace-id or NWEB_WORKSPACE_ID). –body is stored verbatim as HTML (TipTap getHTML() format); mention a member by embedding @Name in the body (the server parses mentions from the body). –parent-comment-id replies to a top-level comment (replies are one level deep)

Flags: --task, --body, --parent-comment-id

Terminal window
retask comment create --task <task-id> --body '<p>Looks good</p>'

Edit a comment’s body (only the author can edit; sets is_edited). –body is HTML, same format and mention syntax as create

Flags: --body

Terminal window
retask comment update <comment-id> --body '<p>Edited</p>'

Delete a comment (soft-delete; deleting a top-level comment cascade-deletes its replies)

Terminal window
retask comment delete <comment-id>

Attach a file to a comment (file IDs come from retask file)

Terminal window
retask comment attachment add <comment-id> <file-id>

Remove a file attachment from a comment

Terminal window
retask comment attachment remove <comment-id> <file-id>