configure_profile_forget
Delete the user's memories that YOU saved or imported. WHICH to delete: if you hold an id, pass id ("mem_..."); if you do NOT have an id and the user names a topic, pass match with a word the memory contains (match: "nursing") and forget finds and deletes your matching memories itself, no search first. HOW: pass reason "user_request" whenever the user wants it gone for good or says never mention it again (this suppresses the content from re-saving and re-importing); use the default correction only for fixing your own mistake. A match previews first: it returns a count and the matching memories and deletes NOTHING until you call again with confirm: true, so review and confirm only what the user meant. import_id (from configure_profile_import) retracts one whole import; scope ("imports", "saved", "all") clears everything of yours at once. Pass exactly one selector. Reach is your own writes only: never another agent's memories, never an import the user ran themselves, never the profile's settled facts, and this deletes memories only, never the Configure account. An id outside your reach returns a clean not-found, not an error. Deletion is permanent for your copy. Returns the deleted memory id and which source it lived under.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | One memory to delete, by the id returned when it was saved (format "mem_...", also shown on entries in your own source box). Use exactly one selector: id, import_id, or scope. | |
| date | No | Optional. The memory's date ("YYYY-MM-DD") if known, from the saved path or entry; providing it makes the delete a direct lookup instead of a namespace scan. | |
| match | No | Selector. Words a memory contains, e.g. "nursing" or "coffee". Finds YOUR OWN matching memories and deletes them, so you do not need a separate search to get ids first. A match WITHOUT confirm:true returns a count and preview and deletes nothing; call again with confirm:true to delete. Reach for this the moment a user says "delete the X stuff" and you do not already hold ids. | |
| scope | No | Delete everything of yours in one call, instead of one id at a time. "imports": every memory you brought in through configure_profile_import, including older imports that predate import ids. "saved": everything you saved with remember or commit. "all": both. Only your own writes are ever touched, so this can never reach another assistant's memories or the profile's settled facts. | |
| reason | No | Optional, default "correction". Use "user_request" ONLY when the user explicitly asked you to remove this and not bring it back (for example "delete that" or "never call me that again") — it additionally suppresses the same content from every source and blocks it from being re-saved or re-imported. Use "correction" (or omit) when you are fixing your own mistake or retracting something stale. | |
| confirm | No | Only with match. Omit or false to preview (count + the memories that match, deletes nothing). Set true to delete the matched memories. Preview first unless the user was unambiguous. | |
| import_id | No | Optional, and used instead of id. The import_id returned by configure_profile_import: retracts every memory that import created, in one call, instead of one delete per memory. Only entries from an import you performed are touched. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | The id of the deleted memory — the confirmation the caller acts on. | |
| error | No | Present when the id was malformed or not found in your namespace. | |
| match | No | The match words this call used, echoed back. | |
| deleted | Yes | Whether anything was removed by this call. False on previews and no-matches. | |
| matched | No | For match-based forgets: how many memories matched. | |
| message | No | ||
| preview | No | Memories a match would delete; nothing is deleted until confirm is true. | |
| deleted_ids | No | Ids of the memories a confirmed match deleted. | |
| deleted_count | No |