Skip to main content
GET
Find datasets by meaning (discovery, not execution)

Authorizations

x-api-key
string
header
required

Optional API key for authentication (enabled via application.yaml)

Query Parameters

query
string
required
limit
integer
default:5
Required range: x <= 25
ai
boolean
default:false

Rerank the top candidates with the primary AI model

includeUnityCatalog
boolean
default:false

Also search the Unity Catalog tables visible to every Databricks Platform secret the key can read. Unity Catalog hits follow the Datris hits with source: unity-catalog; every hit then carries source, and the response adds a unityCatalog block. A secret with no resolvable warehouse or a failed connection is listed under unityCatalog.skipped, never an error; so is a secret whose search exceeds the per-secret time limit (DATRIS_UNITY_CATALOG_SEARCH_TIMEOUT_SECONDS, default 45; reason "timed out after Ns"). limit applies separately: up to limit Datris hits plus up to limit additional Unity Catalog hits. Without this flag the response is unchanged.

Response

Ranked hits

results
object[]
count
integer
totalMatches
integer
unityCatalog
object

Present only with includeUnityCatalog=true