POST
/
v1
/
knowledge-bases
{
  "_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "document_count": 0,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Body

application/json

Data Transfer Object for creating a new Knowledge Base.

​
name
string
required

The name of the knowledge base. Must be unique within your organization and clearly identify its purpose.

Minimum length: 1
​
description
string
required

A comprehensive description of the knowledge base explaining its contents, purpose, and how it will be used by AI agents.

Response

201
application/json
Successful Response

Response model for a Knowledge Base.

​
_id
string
required

Unique identifier of the knowledge base in MongoDB ObjectId format.

​
name
string
required

The name of the knowledge base.

​
created_at
string
required

UTC timestamp indicating when this knowledge base was created.

​
updated_at
string
required

UTC timestamp indicating when this knowledge base was last modified.

​
description
string | null

Detailed description of the knowledge base's purpose and contents.

​
document_count
integer
default:0

Total number of documents currently stored in this knowledge base.