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

# Semantic Layer document object

A document is a markdown note that teaches Nekt — and any assistant reading through MCP — what your
data means: metric definitions, business rules, caveats a column name cannot carry.

Two fields deserve a word:

| Field      |                                                                                                                                    |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `content`  | The markdown body. Mentions written as `@type::identifier` (for example `@table::silver.orders`) are parsed out of it server-side. |
| `mentions` | Read-only. The parsed result of the above — send `content`, never this.                                                            |

`folder` places the document in the tree; omit it (or send `null`) to leave it at the root.

## Related

* [Create a document](/platform-api/semantic-layer/create) and [Update a document](/platform-api/semantic-layer/update).
* [List Semantic Layer Documents](/platform-api/permissions/semantic-layer/list-documents) — the read, with its filters.
* [Semantic Layer](/semantic-layer/overview) — what the module is and how it is used in the app.