Ingest File

Ingest a file asynchronously.

The file is uploaded to object storage, a Document stub is persisted with status='processing' and a background worker picks up the heavy parsing / chunking work.

Args: file: Uploaded file from multipart/form-data. metadata: JSON-string representing user metadata. auth: Caller context – must include write permission. use_colpali: Switch to multi-vector embeddings. folder_name: Optionally scope doc to a folder. end_user_id: Optionally scope doc to an end-user. redis: arq redis connection – used to enqueue the job.

Returns: Document stub with status='processing'.