paperclip_list_issues
Retrieve a paginated list of issues for your company, filterable by status, assignee, project, goal, label, or full-text search.
Instructions
List issues for the current company with filtering and pagination.
Args:
status: string (optional) — Comma-separated statuses (example: "todo,in_progress")
assigneeAgentId: string (optional) — Filter by assignee agent UUID (example: "agt_abc")
projectId: string (optional) — Filter by project UUID
goalId: string (optional) — Filter by goal UUID
labelId: string (optional) — Filter by label UUID
q: string (optional) — Full-text search query (example: "auth bug")
limit: integer (optional) — Max results to return, 1–100 (default 50)
offset: integer (optional) — Skip N results for pagination (default 0)
Returns: Pagination envelope { items: Issue[], total, count, offset, limit, has_more, next_offset } with up to 50 issues per page (default, max 100).
Examples:
Use when: scanning the board for todo issues assigned to a specific agent
Don't use when: you need a single issue's full details — use paperclip_get_issue instead
Error Handling:
401: authentication failed → check PAPERCLIP_API_KEY
403: permission denied → verify PAPERCLIP_COMPANY_ID is correct
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | Comma-separated status values (e.g. 'todo,in_progress') | |
| assigneeAgentId | No | Filter by assignee agent ID | |
| projectId | No | Filter by project ID | |
| goalId | No | Filter by goal ID | |
| labelId | No | Filter by label ID | |
| q | No | Full-text search query | |
| limit | Yes | Maximum number of issues to return (1–100, default 50) | |
| offset | Yes | Number of issues to skip before returning results (default 0) | |
| response_format | Yes | Output format: 'markdown' (default, human-readable) or 'json' (structured) | markdown |