Cards

List cards on a readable board

Same titleContains/textContains/view/includeDeleted contract as MCP list_cards (cardListQuerySchema in lib/schemas/card.ts validates both). titleContains filters server-side, case-insensitively, on card title. textContains (W3-D1) matches case-insensitively on title, description, comment bodies, checklist items AND subtask titles — several words mean every word, each anywhere on the card, an ALIASES: line searched like any text (since 2026-10-16) — always answers view=summary (any other view is refused with 400) and adds match: { field, snippet } — the first field holding every word (title, description, comment, checklist, subtask), or, when the words are spread over fields, the first holding one of them, with a snippet of at most 120 characters; combines with updatedSince (ISO datetime) and citing (a cardKey: cards whose citation graph points at it) — both of which also apply on their own, at every view but lint, which answers every card that needs care and ignores the filters. view defaults to full — today's complete card payload, byte-for-byte unchanged. view=summary returns only id, cardKey, title, listId, startDate, endDate, scheduleState, actualStartDate, actualEndDate, verifiedOn, updatedAt, statusDate, stale (plus match under textContains) — never description, links, verificationSource or assigneeUserIds — to locate a card cheaply before GET /api/cards/{cardId}. statusDate is the dated STATO (or AGGIORNATO) line read from the description's labelled layout, null when neither carries a date; stale is true when that date is more than 14 days old. includeDeleted=true is exclusive trash: only cards with deletedAt set, listId may be null.

get/api/boards/{boardId}/cards

Request

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

Query parameters

titleContainsstring

Case-insensitive substring filter on card title (server-side ILIKE, wildcard-escaped).

textContainsstring

Case-insensitive substring filter on title, description, comment bodies, checklist items and subtask titles; several words mean every word, each anywhere on the card. Requires view=summary; adds match: { field, snippet } to a returned summary when the hit is locatable.

updatedSincestring date-time

ISO datetime; only cards updated at or after it.

citingstring

A cardKey; only cards whose citation graph points at it. A key on a board the caller cannot read answers the empty result, like a key that names no card.

view'full' | 'summary' | 'lint'

'full' (default) returns every field; 'summary' returns the cheap projection (id, cardKey, title, listId, startDate, endDate, scheduleState, actualStartDate, actualEndDate, verifiedOn, updatedAt, statusDate, stale); 'lint' returns only cards with findings as CardLint rows.

includeDeletedboolean

Exclusive trash listing: only cards with deletedAt set. listId may be null. Unlike includeArchived on boards, this is not additive. Default false.

Response

Success

OR
OR
OR

Changes

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