From 675e0dcff18a742285d737fb54a79d566116ae25 Mon Sep 17 00:00:00 2001 From: Dotta Date: Wed, 4 Mar 2026 11:35:13 -0600 Subject: [PATCH] docs: document issue search (q= param) in Paperclip skill The API already supports full-text search via ?q= on the issues list endpoint. Added documentation to both SKILL.md and the API reference so agents know they can search issues by title, identifier, description, and comments. Co-Authored-By: Claude Opus 4.6 --- skills/paperclip/SKILL.md | 11 +++++++++++ skills/paperclip/references/api-reference.md | 2 +- 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/skills/paperclip/SKILL.md b/skills/paperclip/SKILL.md index 375aad79..fb285095 100644 --- a/skills/paperclip/SKILL.md +++ b/skills/paperclip/SKILL.md @@ -207,6 +207,17 @@ PATCH /api/agents/{agentId}/instructions-path | Release task | `POST /api/issues/:issueId/release` | | List agents | `GET /api/companies/:companyId/agents` | | Dashboard | `GET /api/companies/:companyId/dashboard` | +| Search issues | `GET /api/companies/:companyId/issues?q=search+term` | + +## Searching Issues + +Use the `q` query parameter on the issues list endpoint to search across titles, identifiers, descriptions, and comments: + +``` +GET /api/companies/{companyId}/issues?q=dockerfile +``` + +Results are ranked by relevance: title matches first, then identifier, description, and comments. You can combine `q` with other filters (`status`, `assigneeAgentId`, `projectId`, `labelId`). ## Full Reference diff --git a/skills/paperclip/references/api-reference.md b/skills/paperclip/references/api-reference.md index 97f8e376..8d14d201 100644 --- a/skills/paperclip/references/api-reference.md +++ b/skills/paperclip/references/api-reference.md @@ -472,7 +472,7 @@ Terminal states: `done`, `cancelled` | Method | Path | Description | | ------ | ---------------------------------- | ---------------------------------------------------------------------------------------- | -| GET | `/api/companies/:companyId/issues` | List issues, sorted by priority. Filters: `?status=`, `?assigneeAgentId=`, `?projectId=` | +| GET | `/api/companies/:companyId/issues` | List issues, sorted by priority. Filters: `?status=`, `?assigneeAgentId=`, `?assigneeUserId=`, `?projectId=`, `?labelId=`, `?q=` (full-text search across title, identifier, description, comments) | | GET | `/api/issues/:issueId` | Issue details + ancestors | | POST | `/api/companies/:companyId/issues` | Create issue | | PATCH | `/api/issues/:issueId` | Update issue (optional `comment` field adds a comment in same call) |