创建 Memory

在指定 Memory Store 中创建一条 memory。同一 Store 内活跃 path 唯一，重复创建返回 409。创建会自动产生一个 operation=created 的版本快照。

路径

POST /api/v1/forward/memory_stores/{memory_store_id}/memories

请求头

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

路径参数

参数	类型	必选	说明
`memory_store_id`	string	是	Memory Store ID（`memstore_...`）。

请求体

字段	类型	必选	说明
`path`	string	是	库内相对路径，大小写敏感。约束详见 path 规则。
`content`	string	是	UTF-8 明文内容，非 base64；原始字节 ≤100 KiB。约束详见 content 约束。
`metadata`	object	否	键值元数据，值必须为字符串。最多 16 个键。约束详见 Memory metadata 约束。

示例请求

curl -X POST "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memories" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "decisions/arch-choice.md",
    "content": "# 架构决策\n\n选择微服务架构。",
    "metadata": {"owner": "backend-team"}
  }'

示例响应

HTTP 200 OK

{
  "id": "mem_00mc7mvag5u68kkfvxhy",
  "type": "memory",
  "memory_store_id": "memstore_00mc7mukn7lkxr454tjd",
  "path": "decisions/arch-choice.md",
  "content": "# 架构决策\n\n选择微服务架构。",
  "content_size_bytes": 99,
  "content_sha256": "1712de0d497a5aeef2beeccf4fbb7d5a16944975438d0c25447b9c1fba13099a",
  "metadata": {"owner": "backend-team"},
  "created_at": "2026-08-14T10:00:00Z",
  "updated_at": "2026-08-14T10:00:00Z"
}

响应字段解释

返回 Memory 对象，创建响应包含 content。

注意事项

已归档的 Memory Store 不允许创建 memory，返回 409。

错误码

HTTP	type	触发条件
400	`invalid_request_error`	`path` 或 `content` 缺失或非法，`content` 超过 100 KiB，含非打印控制字符，或 `metadata` 违规。
401	`authentication_error`	缺少或无效的认证令牌。
403	`permission_error`	当前调用方无权访问该资源。
404	`not_found_error`	Memory Store 不存在或跨用户不可见。
409	`conflict_error`	同一 Store 内该 `path` 已存在活跃 memory，或 Store 已归档。
500/502/503	`api_error`	Forward 或依赖服务失败。

​路径

​请求头

​路径参数

​请求体

​示例请求

​示例响应

​响应字段解释

​注意事项

​错误码

路径

请求头

路径参数

请求体

示例请求

示例响应

响应字段解释

注意事项

错误码