paperclip_list_feedback_traces
Retrieve company feedback traces with optional filters for type, vote, status, project, issue, and date range. Enables broad auditing and analysis across the organization.
Instructions
⚠ Board-only: List feedback traces for the company, with optional filters for type, vote, status, project, issue, date range, and payload inclusion.
Args:
companyId: string — Company UUID
targetType: string (optional) — Filter by target type
vote: string (optional) — Filter by vote value
status: string (optional) — Filter by trace status
projectId: string (optional) — Filter by project UUID
issueId: string (optional) — Filter by issue ID
from: string (optional) — ISO 8601 datetime lower bound
to: string (optional) — ISO 8601 datetime upper bound
sharedOnly: boolean (optional) — Return only shared traces
includePayload: boolean (optional) — Include full trace payload
response_format: 'markdown' | 'json' (optional, default: markdown)
limit: number (optional) — Max per page, 1–100 (default 50)
offset: number (optional) — Items to skip (default 0)
Returns: Pagination envelope { items: FeedbackTrace[], total, count, offset, limit, has_more, next_offset }.
Examples:
Use when: auditing feedback across the company or filtering by issue, vote, or date range
Don't use when: you need traces for a single issue — use paperclip_list_issue_feedback_traces
Error Handling:
401: authentication failed → check PAPERCLIP_API_KEY
403: permission denied → board-only endpoint, requires board API key
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| companyId | Yes | Company UUID | |
| 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 | |
| projectId | No | Filter by project UUID | |
| issueId | No | Filter by issue ID or identifier | |
| 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) |