创建记忆条目

在 Memory Store 中创建文本记忆条目。

POST /v1/memory_stores/{memory_store_id}/memories

在 active 状态的 Memory Store 中创建 memory entry。响应为 Memory entry 对象，并包含 content。

​

请求头

头部	必选	说明
Authorization	是	Bearer <PAT>
Content-Type	是	application/json

​

路径参数

参数	类型	必选	说明
memory_store_id	string	是	Memory Store ID，前缀为 memstore_

​

请求体

字段	类型	必选	说明
path	string	是	相对路径。服务端会去除首尾空白；最长 1024 byte，不能以 / 开头，不能包含 ..
content	string	是	文本内容。trim 后不能为空，最大 100 KB
metadata	Metadata 对象	否	自定义元数据，省略时为 {}

​

示例请求

curl -X POST "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_xxx/memories" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "notes/meeting.md",
    "content": "会议纪要内容...",
    "metadata": {
      "source": "meeting"
    }
  }'

​

示例响应

HTTP 201 Created

{
  "id": "mem_019e3bb965a671fca51bde1cf8d87de0",
  "type": "memory",
  "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
  "path": "notes/meeting.md",
  "content": "会议纪要内容...",
  "size": 24,
  "content_sha256": "64ec88ca00b268e5ba1a35678a1b5316d212f4f366b2477232534a8aeca37f3c",
  "version": 1,
  "metadata": {
    "source": "meeting"
  },
  "created_at": "2026-05-18T15:34:26.494349Z",
  "updated_at": "2026-05-18T15:34:26.494349Z"
}

​

响应字段

字段	类型	说明
id	string	Memory entry ID，前缀为 mem_
type	string	固定值 "memory"
store_id	string	所属 Memory Store ID
path	string	相对 memory 路径
content	string	创建后的 entry 内容
size	integer	内容大小，单位 byte
content_sha256	string	内容的 SHA-256 摘要
version	integer	当前 entry 版本，初始为 1
metadata	Metadata 对象	自定义元数据
created_at	string	UTC 创建时间
updated_at	string	UTC 最后更新时间

​

注意事项

• 同一个 Store 内 active entry 的 path 必须唯一。
• 创建 entry 会同步生成一条 action: "created" 的 version 记录。
• size 和 content_sha256 由服务端计算。

​

错误码

HTTP	type	触发条件
400	invalid_request_error	path 非法、content 为空或超过 100 KB，或 metadata 非法
401	authentication_error	缺少或无效的认证令牌
404	not_found_error	指定的 Memory Store 不存在
409	conflict_error	Store 已归档，或同一 Store 下已存在相同 path 的 active entry

完整错误信封说明详见 错误参考。

​

相关

Memory Stores

让 Agent 拥有跨 Session 的持久记忆。