Core resources

Files

Upload standalone documents (PDF, DOCX, Markdown, TXT) that assistants can retrieve from — a flat, workspace-level store, separate from named knowledge bases. Files are chunked and embedded automatically.

GET/files knowledge:read

List files

All uploaded files with their ingestion status and size.

bash

curl https://api.bolchoai.in/v1/files -H "Authorization: Bearer $BOLCHO_API_KEY"

Response

json

[ { "id": "…", "name": "handbook.pdf", "type": "pdf", "status": "ready", "chunkCount": 84, "sizeBytes": 240118, "downloadable": true } ]

POST/files knowledge:write

Upload a file

Upload a document (max 50 MB). It's queued for chunking + embedding.

Body

Send as multipart/form-data with the file in the file field.

bash

curl -X POST https://api.bolchoai.in/v1/files -H "Authorization: Bearer $BOLCHO_API_KEY" \
  -F "file=@handbook.pdf"

Response

json

{ "id": "…", "title": "handbook.pdf", "type": "pdf", "status": "pending", "sizeBytes": 240118 }

GET/files/{id}/download knowledge:read

Get download URL

A short-lived signed URL to download the original file.

Path parameters

id*

uuid

File id.

bash

curl https://api.bolchoai.in/v1/files/$ID/download \
  -H "Authorization: Bearer $BOLCHO_API_KEY"

Response

json

{ "url": "https://…?signature=…" }

DELETE/files/{id} knowledge:write

Delete file

Delete the file and its chunks.

Path parameters

id*

uuid

File id.

bash

curl -X DELETE https://api.bolchoai.in/v1/files/$ID \
  -H "Authorization: Bearer $BOLCHO_API_KEY"

Response

json

{ "ok": true }