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

# query_canvas

> Find nodes matching criteria across one or more .canvas files (defaults to all canvases under the vault root).

Find nodes matching criteria across one or more .canvas files (defaults to all canvases under the vault root).

| | |
| - | - |
| **Domain** | structured |
| **Scopes** | `read:canvas` |
| **Access** | read |
| **Tags** | `read-only`, `domain:structured` |
| **Profile** | full only |

## Annotations

| Annotation | Value |
| - | - |
| Read-only | yes |
| Destructive | no |
| Idempotent | no |
| Accepts an idempotency key | no |

`Idempotent` is the advisory MCP `idempotentHint`. `Destructive` is also `yes` for a tool that
asks for confirmation only on some calls.

## Confirmation (human in the loop)

No human confirmation is required to call this tool.

## Input

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `vault` | `string` | | — | Vault id. May be omitted when only one vault is available. length 1–64; pattern `^[a-z0-9_-]+$` |
| `paths` | `string[]` | | — | — |
| `root` | `string` | | — | length 1–1024 |
| `filter` | `object` | | `{}` | — |
| `filter.type` | `enum` | | — | One of: `"text"`, `"file"`, `"link"`, `"group"` |
| `filter.color` | `string` | | — | — |
| `filter.file_path_contains` | `string` | | — | — |
| `filter.text_contains` | `string` | | — | — |
| `filter.has_edge_to` | `string` | | — | — |
| `limit` | `integer` | | — | range 1–1000 |
| `cursor` | `string` | | — | — |

## Output

| Field | Type | Always present | Description |
| - | - | - | - |
| `vault` | `string` | yes | — |
| `total` | `integer` | yes | range ≥ -9007199254740991 |
| `items` | `object[]` | yes | — |
| `items[].canvas_path` | `string` | yes | — |
| `items[].node_id` | `string` | yes | — |
| `items[].type` | `string` | yes | — |
| `items[].snippet` | `string` | | — |
| `canvases_scanned` | `integer` | yes | range ≥ -9007199254740991 |
| `errors` | `object[]` | yes | — |
| `errors[].path` | `string` | yes | — |
| `errors[].code` | `string` | yes | — |
| `next_cursor` | `string` | | — |

## Related tools

Other tools in the `structured` domain: [`add_kanban_card`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/add_kanban_card/), [`create_base`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/create_base/), [`create_canvas`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/create_canvas/), [`create_excalidraw`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/create_excalidraw/), [`format_table`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/format_table/), [`insert_table_column`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/insert_table_column/), [`insert_table_row`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/insert_table_row/), [`list_kanban_boards`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/list_kanban_boards/), [`move_kanban_card`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/move_kanban_card/), [`query_base`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/query_base/), [`read_base`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/read_base/), [`read_canvas`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/read_canvas/), [`read_excalidraw`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/read_excalidraw/), [`read_kanban_board`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/read_kanban_board/), [`sort_table_by_column`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/sort_table_by_column/), [`update_base`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/update_base/), [`update_canvas`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/update_canvas/), [`update_excalidraw`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/update_excalidraw/).

Back to the [tool catalog](https://docs.the40thieves.dev/reliquary-tc/tools/tool-catalog.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.