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
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string (GUID) | Yes | The project to read the comments of. |
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
unresolvedOnly | boolean | No | false | Only threads that are not resolved. |
Response
| Property | Type | Description |
|---|---|---|
projectId | string | The project. |
total | number | Number of threads returned. |
threads | object[] | The threads, in the order they were opened. |
threads[].threadId | string | The thread. |
threads[].itemId | string | The comment pin on the canvas. Missing when the pin is gone. |
threads[].position | object | { x, y }, the pin's top-left corner in canvas coordinates. |
threads[].resolved | boolean | Whether the thread is resolved. |
threads[].resolvedAt, threads[].resolvedBy | string | When and by whom it was resolved, for a resolved thread. |
threads[].attachedTo | object | { 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[].thread | object[] | The posts oldest first: the opening comment, then the replies. |
threads[].thread[].postId | string | The post. |
threads[].thread[].authorId, threads[].thread[].author | string | Who wrote it: the user id and the display name ("unknown member" when the user can no longer be found). |
threads[].thread[].createdAt | string | When it was written. |
threads[].thread[].editedAt | string | When it was last changed; only present on an edited post. |
threads[].thread[].text | string | The 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
| Status | When |
|---|---|
403 | The caller has no access to the project. |
404 | The 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>"