Search Documents

Search indexed knowledge documents with mode selection.

Supports three search modes:

• semantic: Vector similarity search using embeddings (best for conceptual queries)
• keyword: Traditional text-based search (best for exact matches)
• hybrid: Combination of both (recommended, default)

Request Body:

• query: Search query text (required, 1-1000 characters)
• mode: Search mode (semantic, keyword, hybrid). Default: hybrid
• source_ids: Optional list of source IDs to filter by
• limit: Maximum results (1-100). Default: 20
• offset: Number of results to skip. Default: 0

Response:

• results: List of search results with relevance scores
• total: Total matching documents
• mode_used: The search mode that was used

Scores: Each result includes:

• score: Raw relevance score from search engine
• normalized_score: Score normalized to 0-100 range (100 = best match)

Security: Search is scoped to the authenticated user's account index.