Save memory
rememberSave a note, fact, or decision to the user's personal memory store so it can be recalled in future conversations. Saving never deletes or overwrites existing memories. When saving a summary of existing memories, pass their IDs in derived_from so their unresolved conflicts stay visible.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | Access level for this memory: 'shared' (default) or 'private'. | shared |
| source | No | Who is saving this memory (default: 'owner'). | owner |
| content | Yes | Text content of the memory or fact to store | |
| fact_key | No | Optional topic key. Saving again with the same key adds a newer version; earlier versions are kept and marked, nothing is deleted. | |
| source_id | No | Optional label linking this memory to a source document or file. | |
| workspace | No | Named collection to organise memories (default: 'default'). Use to group related memories together. | default |
| confidence | No | Confidence score between 0.0 and 1.0 | |
| source_hash | No | Optional hash of the source content, used to detect when the source has changed. | |
| derived_from | No | When this memory summarizes or condenses existing memories, their IDs. Unresolved conflicts and staleness of those memories stay visible on the summary. | |
| source_revision | No | Optional version tag of the source document. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Unique identifier of the stored memory | |
| scope | Yes | Visibility scope (shared, private, or restricted) | |
| status | Yes | Freshness and trust status: unverified, stale or conflict. A new memory is always unverified | |
| source_id | No | Identifier of the origin document, file, or session | |
| tenant_id | No | Tenant identifier | |
| workspace | Yes | Target workspace containing the memory | |
| created_at | Yes | ISO 8601 creation timestamp | |
| project_id | No | Project identifier | |
| api_version | No | API version of the memory server | |
| source_hash | No | Cryptographic content hash of the source | |
| derived_from | No | IDs of the memories this one summarizes |