The update_memory tool (OwnSona Manual)

Next: The confirm tool, Previous: The list_memories tool, Up: MCP Tools [Contents][Index]

5.7 The `update_memory` tool ¶

Replaces an existing memory’s text and optionally its tags / importance / freshness fields. The embedding is recomputed.

Inputs
Output
Errors

5.7.1 Inputs ¶

id: Required integer. The memory’s id.
text: Required string. The replacement text. Same length / secret-shape constraints as remember.
tags: Array of strings. Optional. Replaces the tag list entirely if provided.
importance: Number, 0–1. Optional.
expires_at: ISO 8601 timestamp. Optional.
last_confirmed_at: ISO 8601 timestamp. Optional.

5.7.2 Output ¶

{
  "ok": true,
  "memory_id": 123,
  "message": "Ok"
}

Updating a soft-deleted memory fails with NOT_FOUND — forget and re-add instead.

5.7.3 Errors ¶

INVALID_INPUT, NOT_FOUND, SECRET_REJECTED, EMBEDDING_ERROR, DATABASE_ERROR.