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
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
projectId | string | Yes | — | The project (map) id. |
text | string | Yes | — | The comment. Leading and trailing spaces are trimmed; it must not be empty. |
itemId | string | No | — | The item the comment is about. The pin goes at its top-right corner, 8 units inside. |
x, y | number | No | — | 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?" }