Skip to main content
POST /api/v1/collections/{collection_id}/files Uploads a file, converts it to text, and indexes it for retrieval. Files up to 100 MB are supported; larger uploads return 413. The upload is idempotent and versioned by path:
  • Re-uploading the same path with identical content returns the existing file unchanged.
  • Re-uploading the same path with new content creates a new version and re-indexes it.
Supported formats include PDF, DOCX, spreadsheets, HTML, images, and plain text. Unsupported formats are stored as-is (status stored) without indexing.

​
Path Parameters

​
string
required
The collection’s UUID.

​
Body Parameters

​
file
required
The file to upload, as multipart/form-data.
​
string
Logical path within the collection (e.g. 2026/reports/q1.pdf). Defaults to the uploaded filename. The path is the file’s stable identity for versioning.

​
Response

Returns a file object with status: "pending". Poll Get File until the status becomes ready (or failed).

​
The File object

​
string
Unique identifier (UUID) for the file. Use this ID in citations and file filters.
​
string
Logical path within the collection — the file’s stable identity.
​
string
Base filename.
​
string
Processing status: pending → processing → ready | failed. Unsupported formats are stored.
​
integer
Version number, incremented each time new content is uploaded to the same path.
​
integer
File size in bytes.
​
integer
Number of pages, when applicable.
​
string
Failure reason when status is failed.
​
string
Timestamp when indexing completed.
Response