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_id}/archive
将一个活跃的 Memory Store 归档。归档后状态变为 archived。
请求头
| 头部 | 必选 | 说明 |
|---|
Authorization | 是 | Bearer <PAT> |
Content-Type | 是 | application/json |
路径参数
| 参数 | 类型 | 必选 | 说明 |
|---|
memory_store_id | string | 是 | Memory Store ID（memstore_ 前缀） |
示例请求
curl -X POST "https://openapi.qoder.sh/api/v1/cloud/memory_stores/memstore_019e3bb8d50674d9b082b73709c29c87/archive" \
-H "Authorization: Bearer $QODER_PAT" \
-H "Content-Type: application/json"
示例响应
HTTP 200 OK
{
"id": "memstore_019e3bb8d50674d9b082b73709c29c87",
"type": "memory_store",
"name": "doc-test-store",
"description": "测试用",
"status": "archived",
"entry_count": 0,
"total_size": 0,
"metadata": {},
"archived_at": "2026-05-18T15:34:00.007987Z",
"created_at": "2026-05-18T15:33:49.449264Z",
"updated_at": "2026-05-18T15:34:00.007987Z"
}
响应字段
| 字段 | 类型 | 说明 |
|---|
id | string | 唯一标识符 |
type | string | 固定值 "memory_store" |
name | string | 存储名称 |
description | string | 存储描述 |
status | string | 归档后为 "archived" |
entry_count | int64 | 记忆条目数量 |
total_size | int64 | 总存储大小（字节） |
metadata | object | 自定义元数据 |
archived_at | string | 归档时间（ISO 8601） |
created_at | string | 创建时间（ISO 8601） |
updated_at | string | 最后更新时间（ISO 8601） |
错误码
| HTTP | type | 触发条件 |
|---|
| 401 | authentication_error | 未提供或无效的认证令牌 |
| 404 | not_found_error | 指定 ID 的 Memory Store 不存在 |
注意事项
- 归档操作会设置
archived_at 时间戳
- 归档后
status 变为 "archived"
- 归档后仍可通过 DELETE 接口彻底删除
- 不需要请求体
完整错误信封说明详见 错误参考。
