Limai Docs
CLI Reference

buckets

File storage bucket management

$limai buckets <subcommand>

Manage file storage buckets. Upload, download, label, and route files to deployments, classifiers, or splitters.

Options
--jsonOutput raw JSON
--verboseEnable debug logging

Subcommands

limai buckets list <projectId>

List all buckets in a project.

limai buckets list <projectId>

limai buckets create <projectId>

Create a new bucket.

$limai buckets create <projectId>

Create a new bucket.

Options
--name <name>Bucket name (required)
--description <description>Bucket description

limai buckets delete <bucketId>

Delete a bucket.

limai buckets delete <bucketId>

limai buckets upload <bucketId> <path>

Upload a single file or all files in a directory to a bucket.

limai buckets upload <bucketId> <path>

limai buckets files <bucketId>

List files in a bucket, optionally filtering by labels.

$limai buckets files <bucketId>

List files in a bucket.

Options
--label <labels...>Filter by one or more labels

limai buckets download <bucketId> <fileId>

Download a file from a bucket.

$limai buckets download <bucketId> <fileId>

Download a file from a bucket.

Options
--output <path>Output file path (defaults to original filename)

limai buckets label <bucketId> <fileId>

Add or remove labels on a file in a bucket.

$limai buckets label <bucketId> <fileId>

Add or remove labels on a file.

Options
--add <labels...>Labels to add
--remove <labels...>Labels to remove

limai buckets send <bucketId> <fileId>

Send a bucket file to a deployment, classifier, or splitter for processing. Exactly one target must be specified.

$limai buckets send <bucketId> <fileId>

Send a bucket file to a deployment, classifier, or splitter.

Options
--deployment <id>Target deployment ID
--classifier <id>Target classifier ID
--splitter <id>Target splitter ID

Examples

Create a bucket

limai buckets create proj_abc123 --name "Invoice Inbox" --description "Incoming invoices"

Upload files to a bucket

limai buckets upload bkt_abc123 ./invoices/

List files with a specific label

limai buckets files bkt_abc123 --label reviewed

Add labels to a file

limai buckets label bkt_abc123 file_xyz789 --add reviewed approved

Remove a label

limai buckets label bkt_abc123 file_xyz789 --remove pending

Download a file

limai buckets download bkt_abc123 file_xyz789 --output ./downloaded-invoice.pdf

Send a file to a deployment for extraction

limai buckets send bkt_abc123 file_xyz789 --deployment dep_456

Send a file to a classifier

limai buckets send bkt_abc123 file_xyz789 --classifier cls_789

Delete a bucket

limai buckets delete bkt_abc123