AnthropicClaude 托管智能体
列出记忆
列出一个记忆库里保存的全部记忆条目。
GET
/anthropic/v1/memory_stores/{memory_store_id}/memories○ 未支持请求参数
memory_store_idstring必填path: 记忆库 ID(路径或查询参数)。
depthnumber可选query: 子节点回溯深度:0(默认)递归返回全部后代,1 只返回直接子节点。
path_prefixstring可选query: 按路径前缀过滤(需以 / 结尾并对齐分段)。
viewstring可选query: 返回投影:basic 省略内容,full 附带完整内容。
limitnumber可选query: 每页返回的条数上限。
pagestring可选query: 分页游标,取自上一页响应的 next_page。
返回
501 平台还没有实现这个端点;调用会得到下面这个响应:
平台还没有提供智能体可读写的持久记忆库。调用会返回 501(not_implemented_error),不产生副作用,官方 SDK 不会重试。
错误按 Claude Managed Agents 格式返回,参见 错误码
响应
HTTP 200
Successful response
application/json
| 名称 | 类型 | 说明 |
|---|---|---|
| data | array<object> | |
| data[].id | string | Unique identifier for this memory (a `mem_...` value). Stable across renames; use this ID, not the path, to read, update, or delete the memory. |
| data[].content_sha256 | string | Lowercase hex SHA-256 digest of the UTF-8 `content` bytes (64 characters). The server applies no normalization, so clients can compute the same hash locally for staleness checks and as the value for a `content_sha256` precondition on update. Always populated, regardless of `view`. |
| data[].content_size_bytes | number | Size of `content` in bytes (the UTF-8 plaintext length). Always populated, regardless of `view`. |
| data[].created_at | string | A timestamp in RFC 3339 format |
| data[].memory_store_id | string | ID of the memory store this memory belongs to (a `memstore_...` value). |
| data[].memory_version_id | string | ID of the `memory_version` representing this memory's current content (a `memver_...` value). This is the authoritative head pointer; `memory_version` objects do not carry an `is_latest` flag, so compare against this field instead. Enumerate the history via List memory versions. |
| data[].path | string | Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`. Always starts with `/`. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes. / The rolled-up path prefix, including a trailing `/` (e.g. `/projects/foo/`). Pass this value as `path_prefix` on a subsequent list call to drill into the directory. |
| data[].type | string | |
| data[].updated_at | string | A timestamp in RFC 3339 format |
| data[].content | null | string | The memory's UTF-8 text content. Populated when `view=full`; `null` when `view=basic`. Maximum 100 kB (102,400 bytes). |
| next_page | string | null |