Write memory
write_memoryCreate or update a keyed memory entry to store durable facts, decisions, and next steps, with prior contents saved automatically for later history review.
Instructions
Create or update a memory by key; previous contents are saved automatically and readable with get_memory_history. Keep entries concise and actionable: save durable facts, decisions, and useful next steps rather than raw transcripts or repeated detail, and provide a short summary. When current evidence corrects an existing fact, update its existing key instead of adding a contradictory duplicate; archive obsolete entries with archive_memories. memory_at is optional and defaults to this save's time; supply an ISO timestamp to preserve an earlier time. is_archived=true hides the entry from normal search/context; false restores it. Tier controls context priority independently of archiving. Requires memory:write or full permission; with memory:propose the write is saved as a proposal (status pending_review) that changes nothing until the owner or an editor approves it. Pass playbook_id as the UUID or GUID of the playbook this call should target.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | Memory key | |
| tags | No | Tags for categorization | |
| tier | No | Memory tier (default: contextual) | |
| value | Yes | JSON value to store | |
| status | No | Task status (for hierarchical task tracking) | |
| summary | No | Compact summary for context views | |
| metadata | No | Free-form metadata: dependencies, thread assignment, progress. Two keys have a defined shape and are validated: metadata.episode as {location, task, outcome} makes the entry findable by where through get_memory_context, while when it happened is memory_at; and metadata.recording holds demonstration references in the same shape a skill uses, as a list of {provider, ref, fidelity, role, segments}. Everything else is stored untouched. | |
| priority | No | Priority 1-100 (default: 50) | |
| memory_at | No | Memory time including timezone; defaults to save time | |
| parent_key | No | Parent memory key for hierarchical organization | |
| description | No | Human-readable description | |
| is_archived | No | Hide from normal search; false restores an archived entry | |
| memory_type | No | flat (default) or hierarchical for task graphs | |
| playbook_id | Yes | UUID or GUID of the target playbook |