knowledge-base

Semantic search across knowledge bases

Changed on
post/v1/knowledge-base/search

Request

Request body

querystring required
kb_idsstring[] required
rerankboolean

Request semantic reranking of the candidate set. For mixed embedding spaces, the service may still rerank automatically when Cohere is configured because raw vector scores are not comparable across spaces.

limitinteger
prefer_draftboolean
version_overridesobject nullable
alphanumber

Hybrid search weighting between dense and sparse vectors. alpha=1.0 is dense-only, alpha=0.5 weights both equally. Minimum is 0.1: sparse-dominant queries on this hybrid index starve dense signal without materially improving recall, and pure sparse (alpha=0.0) sends a degenerate all-zero dense vector that Pinecone rejects.

Response

Successful Response

total_resultsinteger required

Total candidate count before the flat results list is truncated by limit.

ranking_mode'global_score' | 'reranked' | 'grouped_unranked' required

global_score means one embedding space ranked by raw vector score; reranked means a text reranker determined final ordering; grouped_unranked means mixed embedding spaces were returned as separate groups.

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status