Reference

Memories

A Memory is one long-term memory record: a fact with its provenance.

Checked 2026-09-28

A Memory is one long-term memory record: a fact with its provenance.

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

Not available yet. Sylphx Agents is declared in the registry but no backend serves it: every call answers 501 with the problem code UNIMPLEMENTED.

#Fields

Field	Type	What it is
name	string	orgs/{org}/projects/{project}/envs/{env}/memory_stores/{memory_store}/memories/{memory}.
uid	string	mem_<cell><ulid>; never reused. Output only.
meta	ResourceMeta	Resource metadata.
content	string	The memory, at most 16 KiB of text. Required.
end_user	string	The end user it is about, for a store scoped to end users.
agent	string	The agent it belongs to, for a store scoped to agents.
provenance	MemoryProvenance	Where it came from. Output only.
create_time	timestamp	When it was written. Output only.
update_time	timestamp	When it was last changed. 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.

Method	Call	What it does
GET	get	Gets a memory.
GET	list	Lists a store's memories, newest first. With a publishable key, only the caller's end user's memories.
POST	create	Writes a memory.
PATCH	update	Changes a memory's content.
DELETE	delete	Deletes a memory. An end user may delete their own.
POST	search	Recalls the memories that best match a query, by hybrid full-text and vector search. With a publishable key, only the caller's end user's memories. A read with a request body, like a query.

#get

Gets a memory.

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

#list

Lists a store's memories, newest first. With a publishable key, only the caller's end user's memories.

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

#create

Writes a memory.

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

#update

Changes a memory's content.

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

#delete

Deletes a memory. An end user may delete their own.

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

#search

Recalls the memories that best match a query, by hybrid full-text and vector search. With a publishable key, only the caller's end user's memories. A read with a request body, like a query.

POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/memory_stores/memory-store/memories:search · scope agents:sessions · effect read · not available yet · Request, response and examples