paperclip_list_issue_feedback_traces
Retrieve feedback traces for a single issue, applying filters by target type, vote, status, date range, shared status, and payload inclusion. Returns paginated results.
Instructions
⚠ Board-only: List feedback traces scoped to a single issue, with optional filters.
Args:
issueId: string — Issue ID or identifier (example: "PAP-42")
targetType: string (optional) — Filter by target type (example: "comment")
vote: string (optional) — Filter by vote value (example: "up", "down")
status: string (optional) — Filter by trace status (example: "pending", "resolved")
from: string (optional) — ISO 8601 datetime lower bound (createdAt >=)
to: string (optional) — ISO 8601 datetime upper bound (createdAt <=)
sharedOnly: boolean (optional) — Return only shared traces
includePayload: boolean (optional) — Include full trace payload in response
response_format: 'markdown' | 'json' (optional) — Output format (default: markdown)
limit: number (optional) — Max traces per page, 1–100 (default 50)
offset: number (optional) — Number of traces to skip (default 0)
Returns: Pagination envelope { items: FeedbackTrace[], total, count, offset, limit, has_more, next_offset }.
Examples:
Use when: inspecting all feedback traces attached to a specific issue
Don't use when: you need traces across the company — use paperclip_list_feedback_traces instead
Error Handling:
401: authentication failed → check PAPERCLIP_API_KEY
403: permission denied → board-only endpoint, requires board API key
404: issue not found → verify issueId with paperclip_list_issues
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issueId | Yes | Issue ID or identifier (e.g. PAP-42) | |
| targetType | No | Filter by target type (e.g. 'issue', 'comment') | |
| vote | No | Filter by vote value (e.g. 'up', 'down') | |
| status | No | Filter by trace status (e.g. 'pending', 'resolved') | |
| from | No | ISO 8601 datetime — return traces created at or after this timestamp | |
| to | No | ISO 8601 datetime — return traces created at or before this timestamp | |
| sharedOnly | No | When true, return only traces marked as shared | |
| includePayload | No | When true, include full trace payload in response | |
| response_format | Yes | Output format: 'markdown' (default, human-readable) or 'json' (structured) | markdown |
| limit | Yes | Max traces per page (1–100, default 50) | |
| offset | Yes | Number of traces to skip (default 0) |