Skip to main content
POST
Create a knowledge base

Authorizations

Authorization
string
header
required

User API key: Authorization: Bearer mx_live_*. The X-API-KEY: mx_live_* header is also accepted.

X-Organization-ID
string
header
required

Required organization context for org-scoped endpoints.

Body

application/json
name
string
required
Required string length: 1 - 255
description
string | null
embedding_config
object | null

Embedding configuration (provider, model, dimension).

chunking_config
object | null

Chunking configuration (strategy, chunk_size, overlap).

Response

The created knowledge base.

A knowledge base.

id
string<uuid>
organization_id
string<uuid>
created_by_user_id
string<uuid>
credential_id
string<uuid> | null
name
string
description
string | null
embedding_config
object
chunking_config
object
document_count
integer
total_chunks
integer
total_tokens
integer
status
string
created_at
string<date-time> | null
updated_at
string<date-time> | null
stats
object | null