API: Search
Semantic search across dashboards, metrics, model fields, and saved queries. All endpoints require authentication unless noted. 2 endpoints.
POST /api/search/semantic
Section titled “POST /api/search/semantic”Semantic search over dashboards, metrics, model fields and saved queries (AIX-13/22)
Two lanes. Vector (when an embeddings provider is configured): embeds the query via the cosmos gateway and ranks the catalog by cosine similarity, fail-closed re-verified against the live entities. Lexical (AIX-22, the default on keyless deploys and on any vector-lane failure): character-trigram similarity over the live tables plus business-glossary expansion — a query matching a glossary term or synonym also searches the term’s vocabulary and surfaces its linked metric/field assets directly. mode reports which lane answered. Only when BOTH lanes fail is the response {semantic:false, reason, hits:[]}, telling clients to fall back to plain lexical /api/search.
Request body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
q |
string | yes | |
kinds |
array of "dashboard" | "metric" | "model_field" | "saved_query" |
no | |
limit |
integer | no |
Responses: 200 · 400 · 401 · 404
POST /api/search/semantic/reindex
Section titled “POST /api/search/semantic/reindex”Force-refresh the semantic index for the caller’s workspace (AIX-13, admin)
Request body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
force |
boolean | no |
Responses: 200 · 400 · 401 · 403 · 404