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

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.

​
document_language
string
default:en

The language of the documents in the knowledge base. This will be used to filter documents by language when adding to the knowledge base.

Response

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<date-time>
required

UTC timestamp indicating when this knowledge base was created.

​
updated_at
string<date-time>
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_language
string
default:en

The language of the documents in the knowledge base. This will be used to filter documents by language when adding to the knowledge base.

​
document_count
integer
default:0

Total number of documents currently stored in this knowledge base.

​
status
enum<string> | null

Status of the knowledge base. 'processing' means documents are being processed. 'completed' means all documents are processed and ready. 'failed' means there was an error in processing the documents.

Available options:
processing,
completed,
failed