Skip to main content

List Comments

Returns the comment threads on a project's canvas: who wrote what and when, the replies, whether a thread is resolved and the item it is about. It is the REST twin of the MCP tool list_comments and returns the same object.

Endpoint​

GET /api/v2/projects/{projectId}/comments

Authentication​

All requests require a valid API token. You can generate an API token at https://account.deon.cloud/account/api-tokens. Include it as a Bearer token in the Authorization header:

Authorization: Bearer <your-api-token>

The caller needs read access to the project, as for reading the board.

Path Parameters​

ParameterTypeRequiredDescription
projectIdstring (GUID)YesThe project to read the comments of.

Query Parameters​

ParameterTypeRequiredDefaultDescription
unresolvedOnlybooleanNofalseOnly threads that are not resolved.

Response​

PropertyTypeDescription
projectIdstringThe project.
totalnumberNumber of threads returned.
threadsobject[]The threads, in the order they were opened.
threads[].threadIdstringThe thread.
threads[].itemIdstringThe comment pin on the canvas. Missing when the pin is gone.
threads[].positionobject{ x, y }, the pin's top-left corner in canvas coordinates.
threads[].resolvedbooleanWhether the thread is resolved.
threads[].resolvedAt, threads[].resolvedBystringWhen and by whom it was resolved, for a resolved thread.
threads[].attachedToobject{ id, kind, text }, the smallest item under the pin's centre (comments and connectors aside), with its text cut to 100 characters. Missing when the pin is on empty canvas.
threads[].threadobject[]The posts oldest first: the opening comment, then the replies.
threads[].thread[].postIdstringThe post.
threads[].thread[].authorId, threads[].thread[].authorstringWho wrote it: the user id and the display name ("unknown member" when the user can no longer be found).
threads[].thread[].createdAtstringWhen it was written.
threads[].thread[].editedAtstringWhen it was last changed; only present on an edited post.
threads[].thread[].textstringThe full text, with mentions written as @Name.
{
"projectId": "a1b2c3d4-...",
"total": 1,
"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?"
}
]
}
]
}

Empty placeholder posts that older clients create are left out, as the web app does. Manage Comments opens, answers, resolves and deletes threads.

Errors​

StatusWhen
403The caller has no access to the project.
404The project does not exist or cannot be loaded.

Examples​

curl​

curl -X GET "https://api.deon.cloud/api/v2/projects/{projectId}/comments?unresolvedOnly=true" \
-H "Authorization: Bearer <token>"