Skip to main content

Create a knowledge base

POST 

/v1/knowledge-bases

Create an empty knowledge base to hold your own documents.

Send a name plus an optional description and settings object. settings carries the RAG configuration — chunking strategy, search defaults, document summaries, contextual retrieval, semantic caching — and falls back to sensible defaults when omitted. The embedding provider is chosen server-side per KB, so you never pass a model name.

Returns the created knowledge base, including the id every other knowledge-base call takes. Requires the knowledge:write scope.

Request

Responses

Successful Response