Skip to content

Create knowledge base

POST
/knowledge-bases
object
teamId
required

ID of the team that will own this knowledge base

string
name
required

Human-readable name for the knowledge base (1-255 characters)

string
>= 1 characters <= 255 characters
config

Optional configuration settings (uses defaults if not provided)

object
embeddingModels

List of embedding models to generate embeddings for (default: [“BAAI/bge-small-en-v1.5”])

Array<string>
>= 1 items
Allowed values: BAAI/bge-small-en-v1.5 BAAI/bge-base-en-v1.5 BAAI/bge-large-en-v1.5 sentence-transformers/all-MiniLM-L6-v2 sentence-transformers/all-mpnet-base-v2 nomic-ai/nomic-embed-text-v1.5
primaryEmbeddingModel

Primary embedding model used for queries when model is not specified (default: “BAAI/bge-small-en-v1.5”)

string
Allowed values: BAAI/bge-small-en-v1.5 BAAI/bge-base-en-v1.5 BAAI/bge-large-en-v1.5 sentence-transformers/all-MiniLM-L6-v2 sentence-transformers/all-mpnet-base-v2 nomic-ai/nomic-embed-text-v1.5
chunkSize

Token count per chunk (default: 512)

integer
chunkOverlap

Token overlap between chunks (default: 50)

integer
nlpLibrary

NLP library for concept extraction (default: spacy)

string

Knowledge base created successfully

object
knowledgeBaseId
required

Unique identifier for the knowledge base (nanoid format)

string
teamId
required

ID of the team that owns this knowledge base

string
name
required

Human-readable name for the knowledge base

string
config
required

Configuration settings

object
embeddingModels
required

List of embedding models configured for this knowledge base

Array<string>
Allowed values: BAAI/bge-small-en-v1.5 BAAI/bge-base-en-v1.5 BAAI/bge-large-en-v1.5 sentence-transformers/all-MiniLM-L6-v2 sentence-transformers/all-mpnet-base-v2 nomic-ai/nomic-embed-text-v1.5
primaryEmbeddingModel
required

Primary embedding model used for queries when model is not specified

string
Allowed values: BAAI/bge-small-en-v1.5 BAAI/bge-base-en-v1.5 BAAI/bge-large-en-v1.5 sentence-transformers/all-MiniLM-L6-v2 sentence-transformers/all-mpnet-base-v2 nomic-ai/nomic-embed-text-v1.5
chunkSize
required

Token count per chunk

integer
chunkOverlap
required

Token overlap between chunks

integer
nlpLibrary
required

NLP library for concept extraction

string
communitiesStale
required

Whether communities need to be rebuilt due to content changes

boolean
communitiesBuiltAt
required

ISO 8601 timestamp when communities were last built

string format: date-time
nullable
createdAt
required

ISO 8601 timestamp when the knowledge base was created

string format: date-time
updatedAt
required

ISO 8601 timestamp when the knowledge base was last modified

string format: date-time

Bad Request - Validation error or invalid input

object
error
required
string
code
string
details
nullable
retryable
boolean

Unauthorized - Authentication required or invalid token

object
error
required
string
code
string
details
nullable
retryable
boolean

Forbidden - Insufficient permissions

object
error
required
string
code
string
details
nullable
retryable
boolean

Conflict - Resource already exists or operation conflicts with current state

object
error
required
string
code
string
details
nullable
retryable
boolean