POST

Create Knowledge Base

Creates a new, empty knowledge base in the specified sub-account.

POSThttps://api.vantaxai.com/v1/knowledge-bases

After creating a knowledge base, add content to it by attaching sources (text, FAQ, URL, or file). Attach the knowledge base to an Agent so it can reference that content during calls and conversations.

Headers

Authorizationstringrequired
Bearer authentication with your secret API key.
example: Bearer vx_live_3fa9c2…
Content-Typestringrequired
Must be application/json for requests with a body.
example: application/json

Body Parameters

namestringrequired
Display name of the knowledge base.
example: Clinic FAQ
sub_account_idstringrequired
Sub-account that will own the knowledge base.
example: sub_8a1f4c2e
descriptionstringoptional
Internal description of what the knowledge base covers.

Request

curl -X POST https://api.vantaxai.com/v1/knowledge-bases \
  -H "Authorization: Bearer vx_live_3fa9c2..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Clinic FAQ",
  "sub_account_id": "sub_8a1f4c2e",
  "description": "string"
}'

const res = await fetch(
  "https://api.vantaxai.com/v1/knowledge-bases",
  {
  method: "POST",
  headers: {
    Authorization: "Bearer vx_live_3fa9c2...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "Clinic FAQ",
    "sub_account_id": "sub_8a1f4c2e",
    "description": "string"
  }),
  }
);
const { data } = await res.json();

import { Vantax } from "@vantax/sdk";

const vantax = new Vantax({ apiKey: process.env.VANTAX_API_KEY! });
// POST /v1/knowledge-bases
const result = await vantax.request("POST", "/v1/knowledge-bases", {
  "name": "Clinic FAQ",
  "sub_account_id": "sub_8a1f4c2e",
  "description": "string"
});

from vantax import Vantax

vantax = Vantax(api_key=os.environ["VANTAX_API_KEY"])
# POST /v1/knowledge-bases
result = vantax.request("POST", "/v1/knowledge-bases", json={"name": "Clinic FAQ", "sub_account_id": "sub_8a1f4c2e", "description": "string"})

Response

{
  "success": true,
  "message": "Knowledge base created successfully",
  "data": {
    "id": "kb_71ac0",
    "name": "Clinic FAQ",
    "description": "Front-desk answers about hours, insurance, and booking",
    "sub_account_id": "sub_8a1f4c2e",
    "source_count": 0,
    "created_at": "2026-01-14T10:30:00Z"
  }
}

{
  "success": false,
  "message": "Validation failed",
  "errors": [
    { "field": "name", "message": "name is required" }
  ]
}