Skip to main content

create_comment

Open a comment thread on the canvas, pinned to an item (at its top-right corner) or with its pin at x, y in canvas coordinates. The comment is posted under the caller's name. Returns threadId, itemId (the pin), postId and the pin's position; reply_to_comment, resolve_comment and delete_comment take the threadId.

The comment appears under the name of the user the token belongs to: an agent comments as itself, never on someone else's behalf.

Tool name: create_comment

Parameters​

ParameterTypeRequiredDefaultDescription
projectIdstringYes—The project (map) id.
textstringYes—The comment. Leading and trailing spaces are trimmed; it must not be empty.
itemIdstringNo—The item the comment is about. The pin goes at its top-right corner, 8 units inside.
x, ynumberNo—The pin's top-left in canvas coordinates, when no itemId is given.

Pass itemId, or both x and y. A pin is 40×40 units.

Returns​

{
"threadId": "5e6f7a8b-...",
"itemId": "9c0d1e2f-...",
"postId": "aa11bb22-...",
"position": { "x": 352, "y": 208 }
}

itemId is the comment pin, the item get_project lists with kind: "comment". list_comments shows the new thread.

Example​

"Ask the team whether the pricing label is final."

{ "projectId": "a1b2c3d4-...", "itemId": "11aa22bb-...", "text": "Is this price final?" }