CLI Reference
labels
Key:value label management on files and emails
$
limai labels <subcommand>Manage key:value labels on files and emails. List distinct labels, inspect an entity's labels, add or remove labels, and search entities by label.
Options
--jsonOutput raw JSON--verboseEnable debug loggingSubcommands
limai labels list <projectId>
List all distinct labels in a project.
$
limai labels list <projectId>List all distinct labels in a project.
Options
--entity-type <type>Filter by entity type (file|email)limai labels get <projectId> <entityType> <entityId>
Get labels on a specific entity.
limai labels get <projectId> <entityType> <entityId>limai labels add <projectId> <entityType> <entityId> <labels...>
Add one or more labels to an entity.
limai labels add <projectId> <entityType> <entityId> <labels...>limai labels remove <projectId> <entityType> <entityId> <labels...>
Remove one or more labels from an entity.
limai labels remove <projectId> <entityType> <entityId> <labels...>limai labels search <projectId>
Search entities by labels.
$
limai labels search <projectId>Search entities by labels.
Options
--entity-type <type>Filter by entity type (file|email)--labels <labels>Comma-separated key:value pairs to match (AND logic)--key <key>Match all labels with this key prefixExamples
List all labels in a project
limai labels list proj_abc123List only file labels
limai labels list proj_abc123 --entity-type fileGet labels on a file
limai labels get proj_abc123 file file_xyz789Add labels to a file
limai labels add proj_abc123 file file_xyz789 status:reviewed vendor:acmeRemove a label from an email
limai labels remove proj_abc123 email eml_abc123 status:pendingSearch files matching multiple labels
limai labels search proj_abc123 --entity-type file --labels "status:reviewed,vendor:acme"Search by key prefix
limai labels search proj_abc123 --key vendor