list_comments
Access and retrieve comments associated with a task ID. View comment history chronologically or by newest first, handling pagination and full data extraction.
Instructions
List comments newest first (limit default 10), with pagination. Compact fields: id for reply/after, author_name, created_at in UTC to the minute, entire ordinary body. Known automation prefixes get one-line summaries; include_auto=true restores their bodies. full=true restores non-capability REST fields. after accepts a comment UUID or RFC3339 timestamp and returns only newer comments (exclusive), paginated within that delta; unknown IDs are refused. order=asc gives chronological reading.
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": {
"task_id": "<task_id>"
},
"name": "list_comments"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| full | No | Return complete comment objects (author_id, task_id, url, metadata, parent_comment_id, updated_at, uncut bodies) instead of the compact view. | |
| page | No | 1-based page number. Omit for the first page; use with `has_more`/`total_pages` in the response to read the rest of a thread. | |
| after | No | Exclusive comment UUID or RFC3339 timestamp; page/limit apply to the newer-comments delta. Unknown IDs are refused. | |
| limit | No | Max comments to return (default 10, newest first; ordinary bodies are complete). | |
| order | No | Sort direction: desc (default — NEWEST comments first, so limit=2 gives the LAST two comments) or asc (oldest first — chronological reading from the start of the thread). An invalid value is REFUSED by the API; an explicitly empty value is refused locally (at the API boundary it is indistinguishable from absent) — neither is silently treated as asc. | |
| task_id | Yes | Task ID. | |
| include_auto | No | Return complete automation bodies in compact mode. | |
| include_internal | No | Include internal (agent-only) comments. |