Files External API

Upload and manage knowledge sources

The Files External API allows you to upload and manage knowledge sources directly in your datasets via API. Uploaded files are automatically processed, split into chunks, and indexed for semantic search so they can be used by queries and agents.

Supported file types

• PDF

• DOCX

• TXT

• MD

• CSV

• JSON

• HTML

• XML

Maximum file size: 50 MB per file

---

Upload files directly to your datasets via API. Files are automatically processed, chunked, and indexed for semantic search. Credit cost is base + per MB uploaded.

Available endpoints

List files in dataset

GET /api/v1/ext/files/ Returns a list of files stored in the dataset linked to your API key. Cost: Free

---

Upload file to dataset

POST /api/v1/ext/files/upload Uploads a file to your dataset. The file is automatically processed and indexed for semantic search.

Cost: 5 credits base + 1 credit per MB uploaded

---

Reprocess file

POST /api/v1/ext/files/{id}/reprocess Reprocesses an existing file. Use this if processing failed or if you need to rebuild chunks and embeddings.

Cost: 5 credits