Search knowledge
Returns the passages an agent would answer a question from, and how long the search took. Search what an agent uses (agent_id, its draft) or specific source_ids. Listings catalogs aren’t searched by text; use the listings preview instead.
Scopes: knowledge:read
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Body
1 - 500Search what this agent attaches (its draft).
Or exactly these sources.
40playground, phone, web, whatsapp, instagram, messenger, web_chat 1 <= x <= 108Response
Successful Response
The passages an agent would answer from.
Always empty here; use the listings preview for catalogs.
Catalogs among the sources searched.
Filters applied.
Search time in milliseconds.
Total time in milliseconds.
How the passages were found.
What matched.
The search was widened to find something.
Prices are as of this time.
Embedding time in milliseconds.
The embedding model.
A reference for support.