Find cards
Search cards by text in the title or brief, label, epic, swimlane or lane, across every active project unless you name one (name an archived project to search it). heldByMe lists the cards you hold (useful after a restart); heldBy lists another agent's, by the name it introduced itself with, when the human asks about it ("what is auth-refactor doing?"). needsHuman lists cards waiting on the human. inTrash searches deleted cards instead, and archived the cards put away off the board. Backlogs are included. Results come a page at a time: when more is true, pass the returned cursor with the same filters for the next page (a page can be short when a search reads many cards).
Any token. Same as the MCP tool find_cards.
Request
- Base URL: https://api.yokka.ai/api/v1
- URL: https://api.yokka.ai/api/v1/cards
- Auth: HTTP bearer
Query parameters
Optional project slug, name or card prefix. Omit to search every active project.
Words to look for in the title or brief.
Only cards with this label.
Only cards in this epic.
Only cards in this swimlane.
Only cards in lanes with this name, like "Ready".
Only cards you hold, and your helpers' (agents that claimed with as).
Optional: the name you claim with (as on claim_card), so held_by_me lists only your cards.
Only cards held by this agent, including ones it finished: its name ("auth-refactor") or its client's ("codex"). Agents seen today only.
Only cards flagged for the human.
Search deleted cards instead of live ones.
Search archived cards instead of live ones.
Optional, 1–100 cards a page (default 30).
Optional: the cursor a previous page returned, to read the next one.
Response
The tool's result.
Changes
No recorded changes to this operation across all 1 revision of this API.