Skip to content

Knowledge bases API

Create knowledge bases, upload documents, trigger re-indexing, and query indexing status.

Endpoints

Method	Path	Description
`GET`	`/api/v1/knowledge-bases`	List knowledge bases
`POST`	`/api/v1/knowledge-bases`	Create knowledge base
`GET`	`/api/v1/knowledge-bases/{id}`	Get knowledge base
`PATCH`	`/api/v1/knowledge-bases/{id}`	Update settings
`DELETE`	`/api/v1/knowledge-bases/{id}`	Delete knowledge base
`POST`	`/api/v1/knowledge-bases/{id}/documents`	Upload document
`GET`	`/api/v1/knowledge-bases/{id}/documents`	List documents
`DELETE`	`/api/v1/knowledge-bases/{id}/documents/{doc_id}`	Remove document
`POST`	`/api/v1/knowledge-bases/{id}/reindex`	Trigger full re-index
`GET`	`/api/v1/knowledge-bases/{id}/status`	Indexing status

Requires API key or session auth.

Create knowledge base

POST /api/v1/knowledge-bases
Authorization: Bearer ch_live_xxx
Content-Type: application/json

{
  "name": "Help Center",
  "description": "Public FAQ and policy documents",
  "search_settings": {
    "hybrid": true,
    "semantic_weight": 0.7
  }
}

Upload document

Multipart upload for binary files:

curl -X POST "https://api.chatevo.ai/api/v1/knowledge-bases/kb_3fG8hJ1k/documents" \
  -H "Authorization: Bearer ch_live_xxx" \
  -F "file=@./refund-policy.pdf" \
  -F "title=Refund Policy"

Supported types: PDF, DOCX, TXT, MD, HTML. See File types.

Import URL (JSON)

POST /api/v1/knowledge-bases/kb_3fG8hJ1k/documents
Content-Type: application/json

{
  "source_type": "url",
  "url": "https://www.example.com/help/shipping",
  "title": "Shipping FAQ"
}

Indexing status

GET /api/v1/knowledge-bases/kb_3fG8hJ1k/status

{
  "status": "indexing",
  "documents_total": 42,
  "documents_indexed": 38,
  "last_indexed_at": "2026-07-16T09:45:00Z"
}

Status	Meaning
`ready`	All documents indexed and searchable
`indexing`	Processing in progress
`error`	One or more documents failed — check `documents` list for details

Re-index

POST /api/v1/knowledge-bases/kb_3fG8hJ1k/reindex

Triggers a full rebuild of the search index. Use after bulk uploads or search setting changes.