comment_add
Adds a comment to a design element or the document as one atomic action; reuse the same ISO timestamp on retry to prevent duplicates.
Instructions
Add an element-anchored or document comment as an atomic operation. Supply an ISO timestamp; keep it identical on retry.
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": {
"documentId": "<documentId>",
"text": "<text>",
"actor": "<actor>",
"expectedRevision": "<expectedRevision>",
"operationId": "<operationId>",
"commentId": "<commentId>",
"createdAt": "<createdAt>"
},
"name": "comment_add"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ||
| actor | Yes | ||
| pageId | No | ||
| commentId | Yes | ||
| createdAt | Yes | ||
| elementId | No | ||
| documentId | Yes | ||
| operationId | Yes | ||
| expectedRevision | Yes |