Memories

Fields marked * are required. Updates keep every field they are not given. An AI app can ask vritto_describe for the same details, filtered to what its connection may use.

Memory`memory`

An autobiographical memory in the user's own words.

memories_getMemoryFindthrough vritto_find

Fetch one AI-visible Memory when its ID is already known. Private records intentionally return not found.

Field	Type	Description
memoryId*	string

memories_queryMemoriesFindthrough vritto_find

Search AI-visible Memories by text, form, provenance, person, place, tag, fuzzy time, or favorite/pinned state. Use summary detail and a narrow limit unless full recollections are necessary.

Field	Type	Description
query	string
status	one of active, archived, trashed, deleted
form	one of episode, repeated, period, fragment, received_story, shared, collective, composite
lifeEventType	one of first, last, turning_point, achievement, work, education, relationship, family, home, health, travel, birthday, wedding, memorial, personal, other
basis	one of firsthand, co_remembered, told_to_me, media_anchored, document_anchored, inferred, mixed, unspecified
visibility	one of private, ai
sensitivity	one of general, personal, intimate, grief, trauma_sensitive
personId	string
placeKey	string
tag	string
sourceModuleId	string
occurredFrom	string
occurredTo	string
undatedOnly	boolean
favoriteOnly	boolean
pinnedOnly	boolean
includeArchived	boolean
includeTrashed	boolean
detail	one of summary, full
limit	integer
cursor	string

memories_queryMemoryThemeProposalsFindthrough vritto_find

List recurring themes supported by user-entered subjects, patterns, identity labels, or tags across AI-visible Memories. Each proposal includes evidence records; do not treat frequency as importance.

Field	Type	Description
limit	integer

memories_queryRelatedMemoriesFindthrough vritto_find

Find AI-visible Memories connected by shared people, place, time, subject, dynamics, or the user's own tags. Reasons are deterministic and do not claim emotional importance.

Field	Type	Description
memoryId*	string
limit	integer

memories_applyMemoryDraftCreatethrough vritto_create

Create a Memory from an AI-visible draft after the user approves. The original draft and raw transcript remain preserved.

Field	Type	Description
draftId*	string
memory	object
memory.title	string
memory.recollection	string
memory.rawTranscript	string
memory.form	one of episode, repeated, period, fragment, received_story, shared, collective, composite
memory.occurred	object
memory.ended	object
memory.recognizedAt	object
memory.temporalNote	string
memory.basis	one of firsthand, co_remembered, told_to_me, media_anchored, document_anchored, inferred, mixed, unspecified
memory.certainty	one of certain, likely, uncertain, conflicted
memory.perspective	one of first_person, observer, mixed, unclear
memory.peopleIds	list of string
memory.unresolvedPeople	list of string
memory.subjectFacets	list of string
memory.narrativeDynamics	list of string
memory.tags	list of string
memory.emotionsThen	list of string
memory.emotionsNow	list of string
memory.whyItMatters	string
memory.identityThemes	list of string
memory.openQuestions	list of string
memory.visibility	one of private, ai
memory.rediscovery	one of inherit, allow, muted
memory.sensitivity	one of general, personal, intimate, grief, trauma_sensitive
memory.pinned	boolean
memory.favorite	boolean

memories_createMemoryCreatethrough vritto_create

Create an autobiographical Memory from the user's own account. A title, recollection, transcript, or asset is required. Preserve fuzzy dates, provenance, certainty, and sensitivity; visibility defaults to private.

Field	Type	Description
memory*	object
memory.title	string
memory.recollection	string
memory.rawTranscript	string
memory.form	one of episode, repeated, period, fragment, received_story, shared, collective, composite
memory.lifeEventType	one of first, last, turning_point, achievement, work, education, relationship, family, home, health, travel, birthday, wedding, memorial, personal, other
memory.primaryAssetId	string
memory.assetIds	list of string
memory.occurred	object
memory.ended	object
memory.recognizedAt	object
memory.temporalNote	string
memory.basis	one of firsthand, co_remembered, told_to_me, media_anchored, document_anchored, inferred, mixed, unspecified
memory.certainty	one of certain, likely, uncertain, conflicted
memory.perspective	one of first_person, observer, mixed, unclear
memory.peopleIds	list of string
memory.unresolvedPeople	list of string
memory.place	object
memory.subjectFacets	list of string
memory.narrativeDynamics	list of string
memory.sensoryCues	list of object
memory.tags	list of string
memory.emotionsThen	list of string
memory.emotionsNow	list of string
memory.whyItMatters	string
memory.identityThemes	list of string
memory.openQuestions	list of string
memory.catalogRefs	list of object
memory.visibility	one of private, ai
memory.rediscovery	one of inherit, allow, muted
memory.sensitivity	one of general, personal, intimate, grief, trauma_sensitive
memory.pinned	boolean
memory.favorite	boolean
memory.idempotencyKey	string

Example input

{
  "memory": {
    "title": "First snow in Chicago",
    "recollection": "We ran outside at midnight in slippers.",
    "form": "episode",
    "visibility": "ai"
  }
}

memories_patchMemoryUpdatethrough vritto_update

Add detail, correct context, or update the meaning of an existing Memory without replacing omitted fields. Do not change AI visibility without explicit consent.

Field	Type	Description
memoryId*	string
patch*	object
patch.title	string
patch.recollection	string
patch.rawTranscript	string
patch.form	one of episode, repeated, period, fragment, received_story, shared, collective, composite
patch.occurred	object
patch.ended	object
patch.recognizedAt	object
patch.temporalNote	string
patch.basis	one of firsthand, co_remembered, told_to_me, media_anchored, document_anchored, inferred, mixed, unspecified
patch.certainty	one of certain, likely, uncertain, conflicted
patch.perspective	one of first_person, observer, mixed, unclear
patch.peopleIds	list of string
patch.unresolvedPeople	list of string
patch.subjectFacets	list of string
patch.narrativeDynamics	list of string
patch.tags	list of string
patch.emotionsThen	list of string
patch.emotionsNow	list of string
patch.whyItMatters	string
patch.identityThemes	list of string
patch.openQuestions	list of string
patch.visibility	one of private, ai
patch.rediscovery	one of inherit, allow, muted
patch.sensitivity	one of general, personal, intimate, grief, trauma_sensitive
patch.pinned	boolean
patch.favorite	boolean
expectedRevision	integer

memories_setMemoryArchivedUpdatethrough vritto_update

Archive or unarchive a Memory without deleting it.

Field	Type	Description
memoryId*	string
archived*	boolean
expectedRevision	integer

memories_deleteMemoryDeletethrough vritto_delete

Move a Memory to Trash. Use only when the user explicitly asks to remove it.

Field	Type	Description
memoryId*	string
expectedRevision	integer

Memory Draft`memory_draft`

A memory still being written.

memories_createMemoryDraftCreatethrough vritto_create

Create a recoverable Memory draft without adding a Memory. Use when the user wants to keep working before committing the record.

Field	Type	Description
captureMode	one of text, voice, media, source, import
title	string
recollection	string
rawTranscript	string
assetIds	list of string
occurred	object
occurred.precision*	one of day, month, year, decade, approx, range, phrase
occurred.value*	string
occurred.end	string
occurred.label	string
occurred.sortKey	string
form	one of episode, repeated, period, fragment, received_story, shared, collective, composite
lifeEventType	one of first, last, turning_point, achievement, work, education, relationship, family, home, health, travel, birthday, wedding, memorial, personal, other
basis	one of firsthand, co_remembered, told_to_me, media_anchored, document_anchored, inferred, mixed, unspecified
certainty	one of certain, likely, uncertain, conflicted
peopleIds	list of string
place	object
place.placeKey	string
place.capturedLabel*	string
place.coordinates	object
place.address	object
source	object
source.moduleId*	string
source.entityId*	string
source.subEntityId	string
source.relation	one of about, occurred_during, derived_from, evidence, inspired_by, media, person, place, object, other
source.labelSnapshot	string
source.route	string
source.occurred	object
source.sourceRevision	integer
source.sourceState	one of active, changed, missing, deleted
source.active	boolean
catalogRefs	list of object
sensitivity	one of general, personal, intimate, grief, trauma_sensitive
visibility	one of private, ai
idempotencyKey	string

Memory Reflection`memory_reflection`

A present-day reflection attached to a memory.

memories_createMemoryReflectionCreatethrough vritto_create

Attach a present-day reflection to a Memory so later meaning is preserved without rewriting the original account.

Field	Type	Description
memoryId*	string
body*	string
reflectedOn	string
meaningChanged	boolean
visibility	one of private, ai
idempotencyKey	string

memories_deleteMemoryReflectionDeletethrough vritto_delete

Delete one Memory reflection after an explicit request.

Field	Type	Description
memoryId*	string
reflectionId*	string

Kept in the Vritto app

memories_analyzeMemoryDraft: Runs Vritto's own AI; the calling assistant is already an AI.
memories_proposeMemoryNarrativePolish: Runs Vritto's own AI; the calling assistant is already an AI.
memories_queryMemorySemanticSearch: Runs Vritto's own AI; the calling assistant is already an AI.

Memories

Memorymemory

Memory Draftmemory_draft

Memory Reflectionmemory_reflection

Kept in the Vritto app

Memory`memory`

Memory Draft`memory_draft`

Memory Reflection`memory_reflection`