Search

Search the knowledge graph

The headline read. Hybrid retrieval by default (vector + BM25 fused by reciprocal rank), router-boosted, listwise-reranked, then backfilled with each hit entity’s facts. Default semantics is Datomic-style "actual now" — only facts whose validity window contains the query moment; asOf slices world-time and includeStale reverts to the audit shape. userId widens the fence from tenant-global memory to tenant-global PLUS that user's personal rows (fail-closed: omitted means global only). Facts whose predicate requires a scope the caller lacks never enter the result. Fans out to the shared embedding / LLM budget, so it sits in the per-credential expensive throttle bucket — 10 requests/min, not the 120/min default. Source: src/search/search.controller.ts.

Required scope: brain:read.

post/v1/search

Request

  • Base URL: https://brain.inite.ai
  • URL: https://brain.inite.ai/v1/search
  • Auth: HTTP bearer

Request body

asOfstring
confidenceFloornumber
disableLangFilterboolean
entityIdsstring[]
entityTypesstring[]
includeContestedboolean
includeRetractedboolean
includeStaleboolean
limitnumber
minConfidencenumber
outputShape'full' | 'compact' | 'ids'
predicatesstring[]
querystring required
queryLangstring
requireProvenanceboolean
searchMode'vector' | 'lexical' | 'hybrid'
tokenBudgetnumber
userIdstring

Response

Scored entity hits with their facts.

degradedstring[]

Changes

No recorded changes to this operation across all 1 revision of this API.