Upload a file (or batch of files)

Uploads one or more files to the files connector. Each file is:

1. Validated (extension allowlist + 50 MB per-file cap + MIME-type sniff)
2. Stored in MinIO under the knowledgeSources/ prefix
3. Converted to Markdown (Firecrawl for office/PDF, Cortex vision LLM for images, direct read for .md/.txt)
4. Saved as a knowledge_sources row with type='file'
5. Triggers a knowledgeSourceChanged event for Cortex indexing

Single-file mode (backward-compatible): send name="file" — response is {success, id}.

Batch mode: send name="files[]" with multiple parts — response is {successful: [{id, name}], failed: [{name, error}]}. Max 20 files and 50 MB total per request. Files are processed in parallel via Amp futures. Per-file errors land in failed without aborting the batch.

POST /knowledgeSource/filesConnector/upload

Upload a file (or batch of files)

cURL

curl --request POST \
  --url https://demo.enneo.ai/api/mind/knowledgeSource/filesConnector/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form 'files[]=<string>' \
  --form folderId=11 \
  --form files[].items='@example-file'

200

{
  "success": true,
  "id": 42
}

Autorisierungen

bearerAuthcookieAuth

Authorization · string · header · erforderlich

JWT-based authentication

Body

multipart/form-data

file · file

Single-file upload (backward-compatible). Mutually exclusive with files[].

files[] · file[]

Batch upload — multiple files as name="files[]". Max 20 files, 50 MB total.

folderId · integer

Folder structure ID to place the file(s) in. Defaults to the connector root.

Beispiel:

11

Antwort

200

application/json

Single-file: {success: true, id: N}. Batch: {successful: [{id, name}], failed: [{name, error}]} — HTTP 200 even when some files failed.

Option 1

Option 2

success · boolean

Beispiel:

true

id · integer

ID of the created knowledge_sources row

Beispiel:

42