API Reference
Create knowledgebase
Create a new knowledgebase
Updated 25 Jan 2026
On this page
This endpoint creates a new knowledgebase. After creation, you can add documents to it using the create document endpoint.
Request Body
namestringrequired
The name of the knowledgebase (max 255 characters)
descriptionstring
Optional description of the knowledgebase (max 255 characters)
Response
messagestring
Success message
dataobject
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"
}
}
{
"message": "The name field is required.",
"errors": {
"name": [
"The name field is required."
]
}
}
{
"error": "Failed to create knowledgebase. Please try again."
}
Next Steps
After creating a knowledgebase, you'll want to:
- Add documents - Use the create document endpoint to add content
- Wait for processing - Documents are processed asynchronously
- Attach to assistant - Use the update assistant endpoint to attach the knowledgebase
Related guides
API Reference
Introduction
Welcome to the VoxLink API
Read guide →API Reference
Authentication
Learn how to authenticate your API requests
Read guide →API Reference
Get current user
Get the authenticated user's profile information
Read guide →API Reference
List assistants
List all assistants for the authenticated user with pagination
Read guide →