comment_on_document
Leave feedback on a document that is in review. Not an edit — use edit_document to change the document, and reply_to_thread to answer an existing comment. Pass documentId; this comments on the current review version and says so when there is none. Posted as the user's personal agent.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"comment": "<comment>",
"documentId": "<documentId>"
},
"name": "comment_on_document"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| comment | Yes | The comment text to post on the document | |
| documentId | Yes | The document to comment on. The server uses its current review version. | |
| quotedText | No | Optional document text or exact custom-node HTML to anchor the comment to. Use one target, not both text and custom-node HTML. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | ||
| threadId | Yes | ||
| documentVersionId | Yes | The review version the comment was posted on |