search_posts
Search posts on a board. Optional full-text query, status filter, tag filter, and sort. Cursor pagination — pass the previous response’s cursor to get the next page.
required scope: read.
example prompts
Section titled “example prompts”- “find all open feedback about slow exports on the alpha board.”
- “list the top 10 most-voted posts on the public board, then deduplicate them.”
| field | type | required | notes |
|---|---|---|---|
board_id | string | yes | Board id from list_boards. |
query | string (max 200 chars) | no | |
status | enum (open, under_review, planned, in_progress, shipped, declined, duplicate) | no | |
tag_ids | string[] (min 1) | no | |
sort | enum (most_voted, newest, recently_active, relevance) | no | default: "most_voted" |
limit | integer (1-50) | no | default: 25 |
cursor | string | no |
output
Section titled “output”{ "data": [Post, ...], "nextCursor": "..." | null } — same envelope as the rest api.