Correct and forget
Everything Geniffy holds can be corrected or taken out again, at four sizes.
| To | Call | What happens |
|---|---|---|
| Correct one memory | memories.correct(id, text) |
The wrong one is marked and never used again; what is right is learned as a new memory |
| Forget one memory | memories.delete(id) |
That memory, for good |
| Delete one source | sources.delete(id) |
The source, and every memory only it taught |
| Forget one user | forget_space(space) |
Everything held for them |
Correct a memory
mem.memories.correct(42, "Priya signs it, with Arjun co-signing.")await mem.memories.correct(42, "Priya signs it, with Arjun co-signing.");curl -X PATCH https://api.geniffy.com/v1/memories/42 \
-H "Authorization: Bearer $GENIFFY_API_KEY" \
-H "X-Geniffy-Space: customer_1042" \
-H "Content-Type: application/json" \
-d '{"text": "Priya signs it, with Arjun co-signing."}'Nothing is quietly overwritten. The wrong memory is kept, marked, so the correction has something to
point at, and it is never used in an answer again. What is right arrives as a new memory with a source
of its own, titled Correction, so you can always see what changed and why.
Forget a memory
mem.memories.delete(42)await mem.memories.delete(42);The memory is gone for good. Its words are also cut from the stories, lessons and promises read
from the same source and from where things stand, leaving [forgotten] in their place, and the nightly questions
that held them are dropped. The source it came from stays, with whatever else it taught.
Delete a source
mem.sources.delete(source.id)await mem.sources.delete(source.id);The source goes, and so does every memory that only it taught. A memory that another source also taught stays, because something still says it. A value it had replaced, such as a date it moved, stands again unless another source still says something in its place, and a promise it moved goes back to when its other sources said it was due.
To delete every source from one place at once, such as a data source your user disconnected, add them
under its label and use sources.delete_labelled({"channel": "gmail"}).
Give a user a copy of what is held
copy = client.space("user_8841").export()const copy = await client.space("user_8841").export();curl https://api.geniffy.com/v1/export -H "Authorization: Bearer $GENIFFY_API_KEY" -H "X-Geniffy-Space: user_8841"When one of your users asks what you hold about them, this is their copy, as JSON, with where the memory is
kept: every memory, current or not (an older value, a clash, a guess), each with its status and the sentence it
came from; every source that was added, and every file kept under a path, by
its path; and what the memory read from all of it: the stories of what happened, the rules and lessons, and the
promises and plans, each with its status, and where things stand. What was forgotten is gone, so it isn't in it.
Hand it to them as it is, with each file's text from files.get(path).
Forget a user
client.forget_space("user_8841")await client.forgetSpace("user_8841");Everything held for that user, their files included, gone, and nothing else. Their calls come off Requests in the Geniffy app too, and the erase itself is listed there without their space. This is the call to make when one of your users asks to be forgotten, or when your app deletes their account. It cannot be undone. You can also find any space and erase it under Spaces in the Geniffy app.