list_comments
Read the comment threads on a project's canvas - how people review a board - without its other items. Each thread has threadId, itemId (its comment pin, as get_project lists it), position, resolved (with resolvedAt and resolvedBy), attachedTo (the item under the pin: id, kind, text) and thread, its posts oldest first - the opening comment, then the replies - each with postId, author, authorId, createdAt, editedAt when changed, and the full text, mentions written as @Name. Threads come in the order they were opened. Use unresolvedOnly=true for the comments still waiting for an answer.
Comments are how people review a board an agent built. Use this tool for a review pass: read what reviewers asked for, change the board, then check which threads are still open. get_project returns the same threads on its comment items, next to the rest of the board.
Tool name: list_comments
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
projectId | string | Yes | — | The project (map) id, e.g. from list_projects. |
unresolvedOnly | boolean | No | false | Only threads that are not resolved. |
Returns
{
"projectId": "a1b2c3d4-...",
"total": 2,
"threads": [
{
"threadId": "5e6f7a8b-...",
"itemId": "9c0d1e2f-...",
"position": { "x": 412, "y": 96 },
"resolved": false,
"attachedTo": { "id": "11aa22bb-...", "kind": "label", "text": "Q3 Goals" },
"thread": [
{
"postId": "aa11bb22-...",
"authorId": "0f1e2d3c-...",
"author": "Ana Lima",
"createdAt": "2026-10-06T09:14:02+00:00",
"text": "The title is too small - @Ben Ode can you check?"
},
{
"postId": "cc33dd44-...",
"authorId": "4b5a6978-...",
"author": "Ben Ode",
"createdAt": "2026-10-06T10:02:41+00:00",
"editedAt": "2026-10-06T10:05:10+00:00",
"text": "Agreed, 48 pt at least."
}
]
},
{
"threadId": "7d8e9f00-...",
"itemId": "1a2b3c4d-...",
"position": { "x": 1200, "y": 640 },
"resolved": true,
"resolvedAt": "2026-10-07T08:30:00+00:00",
"resolvedBy": "Ana Lima",
"thread": [
{
"postId": "ee55ff66-...",
"authorId": "0f1e2d3c-...",
"author": "Ana Lima",
"createdAt": "2026-10-06T11:20:13+00:00",
"text": "Missing arrow from Research to Design."
}
]
}
]
}
itemIdis the comment pin on the canvas, the itemget_projectlists withkind: "comment". A thread whose pin is gone has noitemIdorposition.positionis the pin's top-left corner in canvas coordinates.attachedTois the item a comment is about. A thread does not store one, so it is the smallest item under the pin's centre, comments and connectors aside, as the web app's assistant takes it. It is left out when the pin is on empty canvas.textis cut to 100 characters.threadholds the posts oldest first: the opening comment, then the replies. Mentions read as@Name.editedAtis only present on a post that was changed.- A person who can no longer be found is called
"unknown member". - Empty placeholder posts that older clients create are left out, as the web app does.
create_comment,reply_to_comment,resolve_commentanddelete_commenttake thethreadId(or the pin'sitemId).
The REST endpoint GET /api/v2/projects/{projectId}/comments returns the same object.
Example
"What did the reviewers say about my board?"
{ "projectId": "a1b2c3d4-...", "unresolvedOnly": true }