---
# @generated by sylphx-gen 0.1.0 from contracts@3118f36f16f799965338811e17ed3a9f565a9f136b14c95e9c94a1e21d42ea3e. Do not edit.
title: "Memories"
description: "The `memories` collection of Sylphx Agents: A Memory is one long-term memory record: a fact with its provenance."
type: reference
product: agents
summary: "A Memory is one long-term memory record: a fact with its provenance."
updated: 2026-09-28
order: 900
---

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`](/docs/api/memories#get) | Gets a memory. |
| `GET` | [`list`](/docs/api/memories#list) | Lists a store's memories, newest first. With a publishable key, only the caller's end user's memories. |
| `POST` | [`create`](/docs/api/memories#create) | Writes a memory. |
| `PATCH` | [`update`](/docs/api/memories#update) | Changes a memory's content. |
| `DELETE` | [`delete`](/docs/api/memories#delete) | Deletes a memory. An end user may delete their own. |
| `POST` | [`search`](/docs/api/memories#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](/docs/api/memories/get)

## 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](/docs/api/memories/list)

## 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](/docs/api/memories/create)

## 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](/docs/api/memories/update)

## 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](/docs/api/memories/delete)

## 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](/docs/api/memories/search)