Comment on a page
View as MarkdownAuthorization
bearer In: header
Path Parameters
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/pages/497f6eca-6276-4993-bfeb-53cbbbba6f08/comments" \ -H "Content-Type: application/json" \ -d '{ "body": "string" }'{ "comment": { "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" }}List a page's comments
Previous Page
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.