Skip to main content

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​

ParameterTypeRequiredDefaultDescription
projectIdstringYes—The project (map) id, e.g. from list_projects.
unresolvedOnlybooleanNofalseOnly 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."
}
]
}
]
}
  • itemId is the comment pin on the canvas, the item get_project lists with kind: "comment". A thread whose pin is gone has no itemId or position.
  • position is the pin's top-left corner in canvas coordinates.
  • attachedTo is 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. text is cut to 100 characters.
  • thread holds the posts oldest first: the opening comment, then the replies. Mentions read as @Name. editedAt is 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_comment and delete_comment take the threadId (or the pin's itemId).

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 }