Cards

Search the cards of a workspace by a word (any member; any token scope)

The REST twin of MCP list_cards with workspace in place of boardId (design record 2026-09-25-workspace-lexical-search-design): one query over every non-archived board the caller can read in the workspace — public boards plus the private ones they are a member of — never a fan-out. Requires textContains and view=summary, and nothing else: the per-board filters (titleContains, updatedSince, citing, includeDeleted) are refused beside the workspace address by name, 400 VALIDATION_ERROR, exactly as MCP refuses them (the shared workspaceCardListQuerySchema in lib/schemas/card.ts). Answers { cards, truncated }: the CardSummary rows of the per-board search — match: { field, snippet } included, same fields, same precedence, same snippet — each with boardId and board (the board's slug), ranked by the field that holds every word of the search — title, then an ALIASES: line, the description, a comment, a checklist item, a subtask title, and last the cards whose words are spread over several fields — most recently updated first within a rank, at most 50, so the cap keeps the best hits (since 2026-10-16; before, time alone). truncated: true means more matched than the cap lists (add a word); truncated: false is a statement of absence: no other live card on the boards you can read carries every word. Archived boards are out of a search as they are out of a listing. A slug the caller does not belong to, and any slug but its audience for a workspace-bound token, answers 404 NOT_FOUND like an unknown one.

get/api/workspaces/{slug}/cards

Request

  • Base URL: https://tre-app.com
  • URL: https://tre-app.com/api/workspaces/{slug}/cards
  • Auth: HTTP bearer

Query parameters

textContainsstring required

The word to find, case-insensitively, anywhere on a card: title, description, comment bodies, checklist items or subtask titles (2 to 100 characters, trimmed). Several words mean every word, each anywhere on the card: fattura cliente finds the card titled "Fattura 12" whose comment says "al cliente" (since 2026-10-16). Required: without it the workspace address is refused.

view'summary' required

Must be summary: a search answers the summary projection plus match, and no other view. Required, as it is beside textContains on the per-board route.

Response

Success

truncatedboolean required

True when more than 50 cards matched and only the 50 best ranked are listed (by the field holding every word — title, ALIASES line, description, comment, checklist, subtask, then words spread over fields — most recently updated first within a rank); false means every match on the boards you can read is here.

Changes

No recorded changes to this operation across all 1 revision of this API.