Upload a file directly to a knowledge store for processing and embedding.
Uploads a file to the specified store using multipart form data. Files up to ~31 MB can be uploaded directly. For larger files, use the chunked upload flow. The file is validated, stored, and automatically queued for processing (chunking and embedding).
organization_id string required
The unique identifier of the organization (format: org_*).
store_id string required
The unique identifier of the vector store.
file file required
The file to upload. See File config for supported types and size limits.
relative_path string optional
A relative path within the store, useful for preserving folder structure in bulk uploads.
The uploaded file object with processing status set to pending (HTTP 201).
- Bash
- Python
- Python
- JavaScript
curl -X POST "https://api.aitronos.com/v1/organizations/org_xyz789/stores/vs_abc123/files/upload" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-F "file=@document.pdf" \
-F "relative_path=reports/2025"