Core resources

Knowledge bases

Give assistants retrieval over your documents and websites. Add sources, then attach the base to an assistant (Assistants → Attach knowledge). The agent searches it during calls via the built-in knowledge_search tool.

GET/knowledge-bases knowledge:read

List knowledge bases

List knowledge bases.

Example request

bash

curl https://api.bolchoai.in/v1/knowledge-bases -H "Authorization: Bearer $VOXA_API_KEY"

POST/knowledge-bases knowledge:write

Create knowledge base

Create an empty knowledge base.

Body

name*

string

Name.

Example request

bash

curl -X POST https://api.bolchoai.in/v1/knowledge-bases \
  -H "Authorization: Bearer $VOXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string"
}'

POST/knowledge-bases/{id}/documents knowledge:write

Add a document

Upload/ingest a document (chunked + embedded for retrieval).

Path parameters

id*

uuid

Knowledge base id.

Example request

bash

curl -X POST https://api.bolchoai.in/v1/knowledge-bases/$ID/documents \
  -H "Authorization: Bearer $VOXA_API_KEY"

POST/knowledge-bases/{id}/websites knowledge:write

Add a website

Crawl & ingest a website URL.

Path parameters

id*

uuid

Knowledge base id.

Body

url*

string

Website URL to crawl.

Example request

bash

curl -X POST https://api.bolchoai.in/v1/knowledge-bases/$ID/websites \
  -H "Authorization: Bearer $VOXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "string"
}'

POST/knowledge-bases/{id}/search knowledge:read

Semantic search

Vector search the base — useful to test retrieval quality.

Path parameters

id*

uuid

Knowledge base id.

Query parameters

topK

number

Results to return (default 5).

Body

query*

string

Search query.

Example request

bash

curl -X POST https://api.bolchoai.in/v1/knowledge-bases/$ID/search \
  -H "Authorization: Bearer $VOXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "string"
}'