> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Search cards

> Search card names and descriptions across visible Trello boards.

`searchCards` uses Trello search syntax and can restrict results to selected boards.

```ts automations/search-trello-cards.automation.ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { searchCards } from "automate.ax/trello"

export default automation("Find launch cards", () => {
  onHttpRequest({ scope: "automation" })
  searchCards({
    query: "launch due:week",
    boardIds: ["board-id"],
    partial: true,
  })
})
```

| Property   | Type                     | Required | Default            | Description                                            |
| ---------- | ------------------------ | -------- | ------------------ | ------------------------------------------------------ |
| `query`    | `string`                 | Yes      | —                  | Non-empty Trello query, including supported operators. |
| `boardIds` | `string[]`               | No       | All visible boards | Restrict search to stable board IDs.                   |
| `limit`    | `number`                 | No       | `50`               | Cards per page, from 1 to 1,000.                       |
| `page`     | `number`                 | No       | `0`                | Zero-based page from 0 to 100.                         |
| `partial`  | `boolean`                | No       | `false`            | Permit prefix matches rather than whole words.         |
| `account`  | Trello account reference | No       | Project default    | Account used to search.                                |

Returns `Signal<TrelloCard[]>` for that page. Increase `page` to retrieve later results.