Knowledge Bases

Create, read, update, and delete knowledge bases.

All endpoints require the dashboard X-Clerk-User-Id header.

List knowledge bases

GET/kbs

Returns id and name for each KB.

curl

curl https://api.docubix.com/kbs -H "X-Clerk-User-Id: your_clerk_user_id"

json

[
  { "id": "...", "name": "Biology Tutor" }
]

Create knowledge base

POST/kbs

curl

curl -X POST https://api.docubix.com/kbs -H "X-Clerk-User-Id: your_clerk_user_id" \
  -H "Content-Type: application/json" \
  -d '{"name": "Biology Tutor", "description": "Optional"}'

Request

json

{
  "name": "Biology Tutor",
  "description": "Optional",
  "settings": {}
}

Response

json

{
  "id": "...",
  "name": "Biology Tutor",
  "status": "active"
}

Get knowledge base

GET/kbs/{kb_id}

Returns counts, settings, and metadata.

curl

curl https://api.docubix.com/kbs/{kb_id} -H "X-Clerk-User-Id: your_clerk_user_id"

Update knowledge base

PATCH/kbs/{kb_id}

json

{
  "name": "Updated name",
  "status": "active",
  "description": "..."
}

Set status to disabled to block public API access for that KB.

Delete knowledge base

DELETE/kbs/{kb_id}

json

{
  "success": true
}