API ReferenceKnowledge Bases

Search Knowledge Bases

Semantic search across a caller-owned list of knowledge bases. Returns ranked chunks with source filename and a cosine-similarity score. Limited to 50 results per request.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Request

This endpoint expects an object.
querystringRequired

Natural-language search query.

kb_idslist of stringsRequired

Knowledge bases to search across. Results scoped to caller-owned entries; unknown IDs are silently ignored.

top_kintegerOptionalDefaults to 5

Max hits to return (default 5, capped at 50).

Response

Ranked search hits across the selected knowledge bases.
hitslist of objects

Errors

400
Bad Request Error
401
Unauthorized Error