from superu import SuperU

client = SuperU("YOUR_SUPERU_API_KEY")
with open("sample.pdf", "rb") as f:
    response = client.knowledge_base.create(
        name="FAQ",
        description="Frequently asked questions",
        files=[f]
    )
print(response)

curl --request POST \\
  --url https://voip-middlware.superu.ai/knowledge-base/create \\
  --header 'superU-Api-Key: YOUR_SUPERU_API_KEY' \\
  --form 'name=FAQ' \\
  --form 'description=Frequently asked questions' \\
  --form 'files=@/path/to/file.pdf'

{
  "status": "success",
  "message": "Knowledge base created successfully. Knowledge base created with embeddings. Processed 1 files into 39 chunks.",
  "data": {
    "knowledge_base_id": "69f9ac509e0388ee380f73d1",
    "kb_uuid": "a7aba494-c043-455c-8429-3ae7e58f957e",
    "name": "FAQ",
    "description": "Frequently asked questions",
    "total_files": 1,
    "files": [
      {
        "original_filename": "faq.pdf",
        "s3_key": "knowledge-base/686e8db4-15df-435e-84fe-b5f6334c2015-faq.pdf",
        "file_url": "https://pluto-superu.s3.amazonaws.com/knowledge-base/686e8db4-15df-435e-84fe-b5f6334c2015-5_letters.csv",
        "file_size": 27500,
        "uploaded_at": {
          "$date": "2026-05-05T08:37:36.632Z"
        },
        "file_content": {
          "$binary": {
            "base64": "...",
            "subType": "00"
          }
        }
      }
    ],
    "embedding_status": "completed",
    "created_at": "2026-05-05T08:37:36.632484"
  }
}

{
  "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."
}