label
Manage source labels in a notebook: auto-categorize, create, rename, assign emoji, move sources, or delete labels. Organize sources into thematic groups.
Instructions
Manage source labels in a notebook. Unified tool for all label operations.
Labels let you organize sources into thematic categories. Requires 5+ sources for auto-labeling. Sources can belong to multiple labels simultaneously.
Supports: auto, list, reorganize, create, rename, set_emoji, move_source, delete
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Label display name (required for create and rename) | |
| emoji | No | Emoji character for set_emoji (e.g. "📊"), or "" to clear | |
| action | Yes | Operation to perform: - auto: AI auto-labels all sources into thematic categories - list: List current labels (triggers AI if none exist) - reorganize: Force AI re-categorization (requires confirm=True unless unlabeled_only=True) - create: Create a new empty label (requires name) - rename: Rename a label (requires label_id, name) - set_emoji: Set or clear emoji on a label (requires label_id, emoji) - move_source: Assign a source to a label (requires label_id, source_id) - delete: Delete label(s) permanently (requires label_id or label_ids, confirm=True) | |
| confirm | No | Must be True for delete action and for reorganize with unlabeled_only=False | |
| label_id | No | Label UUID (required for rename, set_emoji, move_source, delete) | |
| label_ids | No | List of label UUIDs for batch delete (alternative to label_id) | |
| source_id | No | Source UUID to assign (required for move_source) | |
| notebook_id | Yes | Notebook UUID | |
| unlabeled_only | No | For reorganize: if True, only label sources not yet in any label. If False (default), replaces ALL existing labels from scratch (requires confirm=True). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||