Python
from superu import SuperU
client = SuperU("YOUR_SUPERU_API_KEY")
payload = {
"page": 1,
"limit": 10
}
response = client.knowledge_base.list(**payload)
print(response)curl --request POST \\
--url https://voip-middlware.superu.ai/knowledge-base/list \\
--header 'superU-Api-Key: YOUR_SUPERU_API_KEY' \\
--data '{
"page": 1,
"limit": 10
}'{
"status": "success",
"data": {
"knowledge_bases": [
{
"_id": "69f9ac509e0388ee380f73d1",
"name": "FAQ",
"description": "Frequently asked questions",
"files": [
{
"original_filename": "faq.pdf"
}
],
"total_files": 1,
"kb_uuid": "a7aba494-c043-455c-8429-3ae7e58f957e",
"created_at": "2026-05-05T08:37:36.632000",
"embedding_status": "completed",
"total_chunks": 39,
"filenames": [
"5_letters.csv"
]
}
],
"pagination": {
"current_page": 1,
"per_page": 10,
"total_count": 1,
"total_pages": 1,
"has_next": false,
"has_prev": false
}
}
}{
"status": "error",
"code": "BAD_REQUEST",
"message": "Request validation failed."
}{
"status": "error",
"code": "UNAUTHORIZED",
"message": "Invalid or missing superU-Api-Key."
}{
"status": "error",
"code": "NOT_FOUND",
"message": "Resource not found."
}{
"status": "error",
"code": "INTERNAL_SERVER_ERROR",
"message": "An unexpected server error occurred."
}{
"status": "error",
"code": "NOT_IMPLEMENTED",
"message": "This endpoint is not implemented for your workspace."
}Knowledge Base
List knowledge bases
Returns paginated knowledge base records.
POST
/
knowledge-base
/
list
Python
from superu import SuperU
client = SuperU("YOUR_SUPERU_API_KEY")
payload = {
"page": 1,
"limit": 10
}
response = client.knowledge_base.list(**payload)
print(response)curl --request POST \\
--url https://voip-middlware.superu.ai/knowledge-base/list \\
--header 'superU-Api-Key: YOUR_SUPERU_API_KEY' \\
--data '{
"page": 1,
"limit": 10
}'{
"status": "success",
"data": {
"knowledge_bases": [
{
"_id": "69f9ac509e0388ee380f73d1",
"name": "FAQ",
"description": "Frequently asked questions",
"files": [
{
"original_filename": "faq.pdf"
}
],
"total_files": 1,
"kb_uuid": "a7aba494-c043-455c-8429-3ae7e58f957e",
"created_at": "2026-05-05T08:37:36.632000",
"embedding_status": "completed",
"total_chunks": 39,
"filenames": [
"5_letters.csv"
]
}
],
"pagination": {
"current_page": 1,
"per_page": 10,
"total_count": 1,
"total_pages": 1,
"has_next": false,
"has_prev": false
}
}
}{
"status": "error",
"code": "BAD_REQUEST",
"message": "Request validation failed."
}{
"status": "error",
"code": "UNAUTHORIZED",
"message": "Invalid or missing superU-Api-Key."
}{
"status": "error",
"code": "NOT_FOUND",
"message": "Resource not found."
}{
"status": "error",
"code": "INTERNAL_SERVER_ERROR",
"message": "An unexpected server error occurred."
}{
"status": "error",
"code": "NOT_IMPLEMENTED",
"message": "This endpoint is not implemented for your workspace."
}Authorizations
Your SuperU API key.
Body
application/json
Request body for List knowledge bases.
Response
Knowledge bases returned

