EaserixDocs
DevelopersAPI referenceNotesCollaboration

Comments across every page the caller can read

The comment inbox, for people and agents (an MCP/OAuth client or API key acting for a user). Covers every page the caller can read; trashed pages are left out. Each comment is its own row with its parentId, so a thread's replies keep their own authors. Poll with since set to the previous answer's next to get only what was created, edited or resolved after it, oldest first. The cursor is a keyset on (updated_at, id), so comments sharing a timestamp (a bulk resolve) are never dropped at a page boundary.

View as Markdown
GET
/v1/comments
AuthorizationBearer <token>

In: header

Query Parameters

status?string
Default"open"

Value in

  • "open"
  • "resolved"
  • "all"
pageId?string

Only this page (404 if the caller can't read it).

Formatuuid
under?string

A page and every page below it (404 if the caller can't read it). Not with pageId.

Formatuuid
since?string

The previous answer's next, a cursor on (updated_at, id) written "<RFC 3339 time>_". A bare RFC 3339 time also works.

limit?integer
Range1 <= value <= 200
Default50

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/comments"
{  "comments": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "pageId": "347b9bf8-fe00-46f6-b8ca-1e06b3bd5809",      "parentId": "70850378-7d3c-4f45-91b7-942d4dfbbd43",      "authorId": "ee6f7132-bd0a-4fcd-83b3-a8022377067b",      "authorKind": "user",      "body": "string",      "resolvedAt": "2019-08-24T14:15:22Z",      "created": "2019-08-24T14:15:22Z",      "updated": "2019-08-24T14:15:22Z",      "page": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "title": "string"      }    }  ],  "next": "string"}