# POST /knowledge/search

**Resource:** [AI Knowledge](./knowledge.md)  
**Scopes:** `knowledge:read`  
**Write operation:** no

Semantic search across the knowledge base using natural language. Powered by Voyage AI embeddings and pgvector. Returns entries ranked by cosine similarity. Usage count is automatically incremented for returned entries.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `query` | body | string | yes | Natural language search query |
| `category` | body | string | no | Restrict search to a category: general, agent, faq, policy, procedure, product |
| `limit` | body | number | no | Max results (default 5, max 20) |
| `threshold` | body | number | no | Minimum similarity 0.0-1.0 (default 0.3) |

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`