Semantic Layer

Creates, searches, and manages semantic tables, templates, and dictionaries.

📄️ Create Table

Create a semantic table that maps a queryable resource to semantic columns, metrics, filters, and routing links.

List semantic-table version records after read permission is checked. When no history is available, the response is an empty array. Each record includes version identity, latest-version status, timestamps, operation, author, change summary, and storage-reference metadata.

📄️ Get Table

Return a semantic table definition with its columns, metrics, filters, routing links, and source binding.

📄️ Update Table

Update a semantic table (partial; omitted fields unchanged).

📄️ Delete Table

Permanently remove a semantic table definition so it is no longer available for semantic routing.

📄️ List Dictionaries

List semantic dictionaries the user can read.

📄️ Create Dictionary

Create a semantic dictionary resource that can store canonical values and their alternative surface forms.

📄️ Get Dictionary

Return semantic dictionary metadata and its current item count.

📄️ Update Dictionary

Update a semantic dictionary (partial; omitted fields unchanged).

📄️ Delete Dictionary

Delete a semantic dictionary. Rejected (409) while a table references it.

📄️ List Dictionary Items

List dictionary items using `page` and `size`. Use `q` to match a substring in names, labels, and synonyms, and sort results by name or label.

📄️ Upsert Dictionary Items

Insert or update stored dictionary items using the requested `overwrite`, `merge`, or `skip` conflict policy, then schedule a best-effort refresh of the search data.

📄️ Replace Dictionary Items

Replace all stored items in a dictionary and schedule a best-effort refresh of its search data.

📄️ Update Dictionary Item

Update one item, including an atomic canonical-name rename.

📄️ Delete Dictionary Item

Remove the named canonical item and its synonyms. Other entries in the dictionary are retained.

📄️ List Templates

List semantic templates the user can read.

📄️ Create Template

Create a new semantic template (verified at write time: the query must render and compile against the bound table).

📄️ Get Template

Return a semantic template group with its reusable queries, slots, and computation code.

📄️ Update Template

Update a semantic template group (partial; omitted fields unchanged; ``templates`` replaces the whole item list). The merged group is re-verified against every item's bound table.

📄️ Delete Template

Permanently remove a semantic template group and its reusable computation templates.

📄️ Search Dictionary

Return the nearest dictionary candidates for the supplied value.