paperclip_list_approval_comments
Read-only
Retrieve comments on an approval request to review feedback before resubmitting. Returns paginated items with author details.
Instructions
List comments on an approval request.
Args:
approvalId: string — Approval UUID (example: "apr_abc123")
Returns: Pagination envelope { items: Comment[], total, count, offset, limit, has_more, next_offset }. Each item: id, body, authorId, authorType, createdAt.
Examples:
Use when: reading board feedback before resubmitting an approval
Don't use when: you need approval metadata — use paperclip_get_approval for status, type, and payload
Error Handling:
401: authentication failed → check PAPERCLIP_API_KEY
404: approval not found → verify ID with paperclip_list_approvals
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| approvalId | Yes | Approval UUID | |
| limit | Yes | Max comments per page (1–100, default 50) | |
| offset | Yes | Number of comments to skip (default 0) | |
| response_format | Yes | Output format: 'markdown' (default, human-readable) or 'json' (structured) | markdown |