Files API

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

- JSONL

- TSV

- HTML

- XML

- XLSX

- XLS

- Parquet

Maximum file size depends on your plan:

Plan	Max File Size
Free	100 MB per file
Basic	100 MB per file
Pro	500 MB per file

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 over 5 MB

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