Search current active indexed knowledge

Semantic lookup in current active knowledge (up to twenty chunks), including returned sourceId/chunkId for get_knowledge_source/get_knowledge_chunk. Omitted scope filters search the whole connected business; propertyIds selects properties and includeGlobal controls shared knowledge (default true when scoped). This may call the embedding provider. mode=fallback_all means a bounded unranked fallback, not a successful semantic match; totalActive is an eligible count, not returned count. This differs from the runtime planner/scanner and never reproduces a saved answer. Use get_conversation_answer_trace for saved evidence before a new lookup. Inactive knowledge and asset-only uploads are excluded. Required permission: knowledge:read. Connected business only; no tenant override.

post/knowledge/sources/search

Request

  • Base URL
    https://platform-api.visitoai.com/m2m/v1
  • Auth
    HTTP bearer

Request body

querystring required

Search terms for current active indexed knowledge. This performs a new semantic lookup; it is not a saved-answer replay.

topKinteger
sourceType'text' | 'file' | 'url'
propertyIdsstring[]
includeGlobalboolean

Response

Success

mode'vector' | 'all' | 'fallback_all' | 'empty_query' required
totalActiveinteger required

Changes

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