Documentation Index
Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
Use this file to discover all available pages before exploring further.
POST /v1/memory_stores
创建一个新的 Memory Store（记忆存储）。
请求头
| 头部 | 必选 | 说明 |
|---|
Authorization | 是 | Bearer <PAT> |
Content-Type | 是 | application/json |
请求体
| 字段 | 类型 | 必选 | 说明 |
|---|
name | string | 是 | 存储名称（允许重名） |
description | string | 否 | 存储描述 |
示例请求
curl -X POST "https://openapi.qoder.sh/api/v1/cloud/memory_stores" \
-H "Authorization: Bearer $QODER_PAT" \
-H "Content-Type: application/json" \
-d '{
"name": "my-store",
"description": "项目笔记存储"
}'
示例响应
HTTP 201 Created
{
"id": "memstore_019e3bb8d50674d9b082b73709c29c87",
"type": "memory_store",
"name": "my-store",
"description": "项目笔记存储",
"status": "active",
"entry_count": 0,
"total_size": 0,
"metadata": {},
"created_at": "2026-05-18T15:33:49.449264Z",
"updated_at": "2026-05-18T15:33:49.449264Z"
}
响应字段
| 字段 | 类型 | 说明 |
|---|
id | string | 唯一标识符（memstore_ 前缀） |
type | string | 固定值 "memory_store" |
name | string | 存储名称 |
description | string | 存储描述 |
status | string | 状态：active / archived / deleted |
entry_count | int64 | 记忆条目数量 |
total_size | int64 | 总存储大小（字节） |
metadata | object | 自定义元数据 |
created_at | string | 创建时间（ISO 8601） |
updated_at | string | 最后更新时间（ISO 8601） |
错误码
| HTTP | type | 触发条件 |
|---|
| 401 | authentication_error | 未提供或无效的认证令牌 |
注意事项
- 同名 Memory Store 允许创建，不会冲突
- 新建的 Store 初始状态为
active
entry_count 和 total_size 初始值为 0
完整错误信封说明详见 错误参考。
