Skip to main content
POST
/
v1
/
knowledgebases
Create knowledge base
curl --request POST \
  --url http://co-mind-platform-host/v1/knowledgebases \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "My Knowledge Base",
  "description": "Technical documentation for our product",
  "is_private": true
}
'
{
  "id": "kb_abc123",
  "object": "knowledgebase",
  "name": "My Knowledge Base",
  "description": "Technical documentation",
  "is_private": true,
  "created_at": 1699564800,
  "updated_at": 1699564800,
  "file_count": 5,
  "size_bytes": 102400
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Supports two token types:

  • JWT Access Token — obtained via POST /v1/auth/login
  • Personal Access Token (PAT) — created via POST /v1/api-tokens, format: cmnd_<tokenId>.<secret>

Body

application/json
​
name
string
required

Name of the knowledge base

Example:

"My Knowledge Base"

​
description
string

Description of the knowledge base

Example:

"Technical documentation for our product"

​
is_private
boolean
default:true

Whether the knowledge base is private

Response

Knowledge base created successfully

​
id
string
Example:

"kb_abc123"

​
object
string
Example:

"knowledgebase"

​
name
string
Example:

"My Knowledge Base"

​
description
string
Example:

"Technical documentation"

​
is_private
boolean
Example:

true

​
created_at
integer

Unix timestamp

Example:

1699564800

​
updated_at
integer

Unix timestamp

Example:

1699564800

​
file_count
integer
Example:

5

​
size_bytes
integer
Example:

102400