# AI Knowledge

Manage company AI Knowledge entries with semantic search powered by Voyage AI embeddings. Use for policies, FAQs, agent instructions, and product documentation.

**Base URL:** `https://api.trustpager.com/functions/v1/api/v1`

## Endpoints

### GET /knowledge

List all knowledge base entries. Filter by category or tag.

**Scopes:** `knowledge:read` — [full detail](./knowledge/get-knowledge.md)

### GET /knowledge/:id

Retrieve a single knowledge base entry by ID. The id must be a complete UUID (e.g. "203cf566-22ff-4dd3-87c7-22983d630a31"). Passing a truncated UUID returns a VALIDATION_ERROR with a clear message.

**Scopes:** `knowledge:read` — [full detail](./knowledge/get-knowledge-id.md)

### POST /knowledge

Create a knowledge base entry. An embedding is automatically generated for semantic search. Valid categories: general (default), agent, faq, policy, procedure, product.

**Scopes:** `knowledge:write` — [full detail](./knowledge/post-knowledge.md)

### PATCH /knowledge/:id

Update a knowledge base entry. If title or content changes, the embedding is automatically regenerated. The id must be a complete UUID - truncated values return VALIDATION_ERROR.

**Scopes:** `knowledge:write` — [full detail](./knowledge/patch-knowledge-id.md)

### DELETE /knowledge/:id

Delete a knowledge base entry permanently. The id must be a complete UUID - truncated values return VALIDATION_ERROR.

**Scopes:** `knowledge:write` — [full detail](./knowledge/delete-knowledge-id.md)

### POST /knowledge/search

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.

**Scopes:** `knowledge:read` — [full detail](./knowledge/post-knowledge-search.md)