POST /v1/memoriesStores one memory. With infer enabled the text is read as a passage and every durable fact in it becomes its own memory. Accepted asynchronously. The memory and each fact count against the account's monthly write allowance: a write is refused once the allowance is used up, and facts past it are discarded. A write is also refused, and facts that would form new memories are discarded, once the account holds its plan's limit of stored memories. A write resent while an identical one is still forming is accepted and counts against neither the write allowance nor the stored-memory limit. When identical writes are sent before the first is answered, one is stored and the others can be refused.
Guide: Store memories
GET /v1/memoriesGuide: List memories
POST /v1/memories/importImports one conversation as an ordered list of chat turns and forms memories from it. Accepted asynchronously; the memories appear once formation completes. A conversation and the facts formed from it count against the account's monthly write allowance: an import is refused once the allowance is used up, and the part of a conversation past it, and the facts past it, are discarded. An import is also refused, and facts that would form new memories are discarded, once the account holds its plan's limit of stored memories. An import resent while every part of it is still forming is accepted and counts against neither the write allowance nor the stored-memory limit. When identical imports are sent before the first is answered, one is stored and the others can be refused.
Guide: Import conversations
GET /v1/memories/{memory_id}Guide: Get one memory
DELETE /v1/memories/{memory_id}Forgets the memory. Its text, versions, relationships and feedback stay stored until the project is deleted.
Guide: Forget a memory
GET /v1/memories/{memory_id}/inspectReturns one active memory with its version history and its relationships to active memories. A forgotten or missing memory is 404. Each call counts the reads it costs against the account's monthly read allowance, a miss included, and is refused when fewer reads are left than it costs. The `Alvia-Usage` response header shows the reads the call used.
Guide: Inspect a memory
POST /v1/memories/searchGuide: Search memories
POST /v1/memories/recallReturns the single best memory for the query. A miss is 200 with status not_found, never 404. 404 means the selected project was not found. Each call counts the reads it costs against the account's monthly read allowance, a miss included, and is refused when fewer reads are left than it costs. The `Alvia-Usage` response header shows the reads the call used.
Guide: Recall the best memory
POST /v1/memories/contextReturns short context synthesized from the memory that best matches the query and the memories related to it. 404 when no context is available. Each call counts the reads it costs against the account's monthly read allowance, a miss included, and is refused when fewer reads are left than it costs. The `Alvia-Usage` response header shows the reads the call used.
Guide: Get context
PUT /v1/memories/{memory_id}/feedbackGuide: Give feedback