Skip to main content

delete_comment

Delete a whole comment thread with its pin on the canvas, or with postId a single post of it. A whole thread can be deleted by whoever opened it or by someone who can edit the board; a post only by its author. Deleting the last post of a thread deletes the thread. Comment pins are deleted here, not with delete_items.

Tool name: delete_comment

Parameters​

ParameterTypeRequiredDefaultDescription
projectIdstringYes—The project (map) id.
threadIdstringYes—The thread: its threadId from list_comments, or its pin's itemId.
postIdstringNo—Delete only this post of the thread, e.g. a reply. Omit to delete the whole thread.

Returns​

{ "threadId": "5e6f7a8b-...", "deleted": "thread" }
{ "threadId": "5e6f7a8b-...", "postId": "cc33dd44-...", "deleted": "post" }

Deleting a thread removes its pin from the canvas along with every post. Who may delete what:

  • A whole thread: the person who opened it, or anyone who can edit the board. A viewer can delete only threads they opened.
  • A post: only its author. Someone who can edit the board deletes the whole thread instead if a post has to go.
  • The last post of a thread: deleting it deletes the thread and its pin, so no empty pin is left on the canvas. The result then says "deleted": "thread".

Example​

"Clean up the review comments before we share the board."

{ "projectId": "a1b2c3d4-...", "threadId": "5e6f7a8b-..." }