Limai Docs
CLI Reference

upload

Upload files and folders for extraction

$limai upload <extractionSchemaId> <path>

Upload a single file or an entire folder for data extraction. Supports concurrent uploads, glob filtering, automatic processing, and waiting for results.

Options
--concurrency <n>Number of concurrent uploads for folder uploads(default: 5)
--processQueue files for extraction after upload
--waitWait for all extractions to complete (implies --process)
--output <file>Write results to a JSON file
--glob <pattern>Filter files by glob pattern (folder uploads only)
--jsonOutput raw JSON
--verboseEnable debug logging

Behavior

Single file: Uploads the file and optionally queues it for extraction.

Folder: Scans the directory for supported files, uploads them concurrently, and reports results. Duplicate files are detected and skipped.

When --wait is used, the CLI polls until all extraction jobs complete and optionally writes the extracted data to a file.

Examples

Upload a single file

limai upload es_abc123 ./invoice.pdf

Upload and extract immediately

limai upload es_abc123 ./invoice.pdf --process

Upload, extract, and wait for results

limai upload es_abc123 ./invoice.pdf --wait --output results.json

Upload a folder of PDFs

limai upload es_abc123 ./documents/ --glob "*.pdf"

Bulk upload with higher concurrency

limai upload es_abc123 ./documents/ --concurrency 10 --process

Upload folder, process, and wait for all

limai upload es_abc123 ./documents/ --wait --output batch-results.json