> ## 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.

# get_conventions

> Return the vault conventions that apply to a note or folder: the SCHEMA.md layers that carry a conventions: block (root first, nearest last) and their merged rules (type key, required frontmatter, ...

Return the vault conventions that apply to a note or folder: the SCHEMA.md layers that carry a conventions: block (root first, nearest last) and their merged rules (type key, required frontmatter, allowed values per property and per type), each with the layer it came from. Call it before creating or editing notes in a folder, to learn the required frontmatter and allowed values. Layers you cannot read are omitted. Domain: metadata. response\_format=concise drops layers and every source.

| | |
| - | - |
| **Domain** | metadata |
| **Scopes** | `read:notes` |
| **Access** | read |
| **Tags** | `read-only`, `domain:metadata` |
| **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_-]+$` |
| `path` | `string` | | — | length 1–1024 |
| `response_format` | `enum` | | — | concise returns only the high-signal fields; detailed (the shipped default) returns the full payload. Errors and safety warnings are never trimmed. When omitted, the server's tools.defaults.responseFormat applies. One of: `"concise"`, `"detailed"` |
| `verbosity` | `enum` | | — | Legacy alias for response\_format: terse = concise, full = detailed. One of: `"full"`, `"terse"` |

## Output

| Field | Type | Always present | Description |
| - | - | - | - |
| `vault` | `string` | yes | — |
| `path` | `string` | yes | — |
| `layers` | `object[]` | | — |
| `layers[].path` | `string` | with parent | — |
| `layers[].inherit` | `boolean` | with parent | — |
| `layers[].version` | `integer` | with parent | range ≥ -9007199254740991 |
| `effective` | `object` | yes | — |
| `effective.required` | `object` | | — |
| `effective.values` | `Record<string, object>` | yes | — |
| `effective.severity` | `Record<string, object>` | | — |
| `effective.type_key` | `object` | | — |
| `effective.types` | `Record<string, object>` | yes | — |
| `hint` | `string` | | — |
| `file_warnings` | `object[]` | | — |
| `file_warnings[].path` | `string` | with parent | — |
| `file_warnings[].message` | `string` | with parent | — |
| `file_warnings_omitted` | `integer` | | range ≥ -9007199254740991 |

## Related tools

Other tools in the `metadata` domain: [`add_tag`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/add_tag/), [`bulk_set_property`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/bulk_set_property/), [`find_notes_by_property`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/find_notes_by_property/), [`find_notes_by_tag`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/find_notes_by_tag/), [`get_note_tags`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/get_note_tags/), [`list_properties`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/list_properties/), [`list_tags`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/list_tags/), [`read_frontmatter`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/read_frontmatter/), [`read_metadata_fields`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/read_metadata_fields/), [`read_property`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/read_property/), [`remove_tag`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/remove_tag/), [`suggest_tags`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/suggest_tags/), [`update_frontmatter`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/update_frontmatter/).

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.