Skip to main content
POST
Create a new knowledge base

Headers

x-user-id
string
required

Caller's user ID. Temporary header-based identity; will be replaced by JWT auth.

Body

application/json

Request body for creating a new knowledge base.

name
string
required

Display name of the knowledge base.

embedding_model_config
EmbeddingModelConfig · object
required

Embedding model used both at indexing and at query time. Cannot be changed after creation — switching would invalidate every previously inserted vector.

description
string
default:""

Free-form description shown in the UI.

Response

Successful Response

Response body after creating a knowledge base.

knowledge_base_id
string
required

Server-assigned knowledge base identifier.