Skip to content
Console
On this page

Memory stores

A MemoryStore holds long-term memory records with provenance, recalled by hybrid full-text and vector search.

A MemoryStore holds long-term memory records with provenance, recalled by hybrid full-text and vector search. The records are Sylphx Knowledge episodes in the store's Knowledge spaces, read and written as the caller. Agents name the stores they use; a store may be shared by many agents.

Service Sylphx Agents · Resource type agents.sylphx.com/MemoryStore · Name pattern orgs/{org}/projects/{project}/envs/{env}/memory_stores/{memory_store} · Shape spec_status

Fields

FieldTypeWhat it is
namestringorgs/{org}/projects/{project}/envs/{env}/memory_stores/{memory_store}.
uidstringmst_<cell><ulid>; never reused. Output only.
metaResourceMetaResource metadata.
specMemoryStoreSpecDesired state. Required.
statusMemoryStoreStatusObserved state. Output only.

Methods

Every method of the collection, in the registry's order, with the scope it needs. The full request, response and examples are one link away.

MethodCallWhat it does
GETgetGets a memory store.
GETlistLists memory stores.
POSTcreateCreates a memory store.
PATCHupdateUpdates a memory store.
DELETEdeleteDeletes a memory store. A store an agent names is refused with RESOURCE_IN_USE; a store with memories is refused with INVALID_STATE unless force is set, which deletes them too.

get

Gets a memory store.

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/memory_stores/memory-store · scope agents:read · effect read · Request, response and examples

list

Lists memory stores.

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/memory_stores · scope agents:read · effect read · paginated · Request, response and examples

create

Creates a memory store.

POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/memory_stores · scope agents:write · effect write · Request, response and examples

update

Updates a memory store.

PATCH https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/memory_stores/memory-store · scope agents:write · effect write · Request, response and examples

delete

Deletes a memory store. A store an agent names is refused with RESOURCE_IN_USE; a store with memories is refused with INVALID_STATE unless force is set, which deletes them too.

DELETE https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/memory_stores/memory-store · scope agents:write · effect destructive · Request, response and examples