create_document_comments
Add multiple comments to a Polarion document in one request, including threaded replies and HTML formatting, for efficient documentation feedback.
Instructions
Create one or more comments on a document in one request.
Reply: set parent_comment_id to a short id from list_document_comments (None = top-level). 'text/html' text is sent unsanitized. Always authored by the token's user. NOT idempotent — a retry duplicates. attachment:{id} image refs in text/html comments must name an existing document attachment — resolve via list_document_attachments first.
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": {
"project_id": "<project_id>",
"space_id": "<space_id>",
"document_name": "<document_name>",
"comments": "<comments>"
},
"name": "create_document_comments"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | Preview payload without writing; guards still query Polarion. | |
| comments | Yes | Comments to create in one request. | |
| space_id | Yes | Space ID ('_default' = default space). | |
| project_id | Yes | Polarion project ID. | |
| document_name | Yes | Document name within space_id. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| created | Yes | ||
| dry_run | Yes | ||
| comment_ids | Yes | ||
| payload_preview | Yes |