paperclip_list_labels
Fetch paginated labels with name, color, and ID to build a label taxonomy cache. Essential for mapping label names to UUIDs in subsequent calls.
Instructions
List all labels defined for the current company.
Args:
limit: number — Max labels per page (1–100, default 50)
offset: number — Number of labels to skip (default 0)
response_format: 'markdown' | 'json' (optional) — Output format (default: markdown)
Returns: Pagination envelope { items: Label[], total, count, offset, limit, has_more, next_offset }. Each item: id, name, color (hex), createdAt.
Examples:
Use when: bootstrapping the label taxonomy at the start of a run to build a name→UUID cache
Don't use when: you already have the label UUID — pass it directly to the relevant tool
Error Handling:
401: authentication failed → check PAPERCLIP_API_KEY
403: permission denied → verify PAPERCLIP_COMPANY_ID is correct
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | Yes | Max labels per page (1–100, default 50) | |
| offset | Yes | Number of labels to skip (default 0) | |
| response_format | Yes | Output format: 'markdown' (default, human-readable) or 'json' (structured) | markdown |