add_labels
Adds to what’s already there. Existing labels are preserved — only the new ones are appended.
Parameters #
| Parameter | Type | Required | Description |
|---|---|---|---|
memory_id | number | Yes | The ID of the memory to update |
labels | string | Yes | Comma-separated labels to add |
Examples #
# Add a single label
add_labels(memory_id: 42, labels: "important")
# Add multiple labels at once
add_labels(memory_id: 42, labels: "reviewed,approved,2026-03-01")
Power Combinations #
Reminder workflow — tag memories for follow-up, then clean up when done:
# Flag for action
add_labels(memory_id: 101, labels: "reminder")
# Later, once actioned — use del_labels to remove, or replace_labels for atomic swap
Progressive enrichment — start with broad labels at store time, refine later as context develops:
store_memory(content: "...", labels: "wip")
# ... work progresses ...
add_labels(memory_id: 101, labels: "architecture,decision,approved")
del_labels(memory_id: 101, labels: "wip")
For atomic label swaps — removing one label while adding others in a single operation — see replace_labels. It was built for exactly this pattern.