Skip to main content
POST
/
user
/
knowledgebases
Create knowledgebase
curl --request POST \
  --url https://call.aiployees.com/api/user/knowledgebases \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>"
}
'
{
  "message": "Knowledgebase created successfully.",
  "data": {
    "id": 1,
    "name": "Product Documentation",
    "description": "Technical documentation for our products",
    "status": "empty",
    "status_label": "Empty",
    "created_at": "2025-01-08T10:30:00.000000Z",
    "updated_at": "2025-01-08T10:30:00.000000Z"
  }
}
This endpoint creates a new knowledgebase. After creation, you can add documents to it using the create document endpoint.

​
Request Body

​
name
string
required
The name of the knowledgebase (max 255 characters)
​
description
string
Optional description of the knowledgebase (max 255 characters)

​
Response

​
message
string
Success message
​
data
object
The created knowledgebase object
{
  "message": "Knowledgebase created successfully.",
  "data": {
    "id": 1,
    "name": "Product Documentation",
    "description": "Technical documentation for our products",
    "status": "empty",
    "status_label": "Empty",
    "created_at": "2025-01-08T10:30:00.000000Z",
    "updated_at": "2025-01-08T10:30:00.000000Z"
  }
}

​
Next Steps

After creating a knowledgebase, you’ll want to:
  1. Add documents - Use the create document endpoint to add content
  2. Wait for processing - Documents are processed asynchronously
  3. Attach to assistant - Use the update assistant endpoint to attach the knowledgebase