paperclip_list_projects
Read-only
Retrieve all projects for your company in markdown or JSON format to find project IDs for linking issues.
Instructions
List all projects for the current company.
Args:
response_format: 'markdown' | 'json' (optional) — Output format (default: markdown)
Returns: Pagination envelope { items: Project[], total, count, offset, limit, has_more, next_offset }. Each item: id, name, status, goalId, createdAt.
Examples:
Use when: finding the projectId to link when creating a new issue
Don't use when: you need a project's workspaces — use paperclip_get_project or paperclip_list_workspaces
Error Handling:
401: authentication failed → check PAPERCLIP_API_KEY
403: permission denied → verify PAPERCLIP_COMPANY_ID is correct
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | Yes | Max projects per page (1–100, default 50) | |
| offset | Yes | Number of projects to skip (default 0) | |
| response_format | Yes | Output format: 'markdown' (default, human-readable) or 'json' (structured) | markdown |