Skip to main content

列出 Memory Store

分页列出当前工作空间的记忆库,按创建时间倒序。

前提

已完成 Endpoint 与鉴权配置,详见API 总览与认证。

接口

GET /memory_stores

Query 参数

include_archived boolean (可选)默认 false 只返回未归档;true 同时返回未归档与已归档limit integer (可选)单页条数,1-100,默认 20page string (可选)分页游标。首次不传,后续传上一次响应的 next_page 翻下一页

请求示例

curl "$AGENTSTUDIO_URL/memory_stores" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

响应字段

data array<object>记忆库数组id string记忆库 ID,格式 memstore_xxxtype string固定为 memory_storename string记忆库名称,1-255 字符description string用途说明;未填写时为空字符串metadata object业务自定义键值对元数据archived_at string | null归档时间,未归档时省略或为 nullcreated_at string创建时间,ISO 8601 UTCupdated_at string最近更新时间,ISO 8601 UTCnext_page string | null下一页游标;响应不含该字段或为 null 时表示末页

响应

{
  "data": [
    {
      "id": "memstore_xxx",
      "type": "memory_store",
      "name": "项目知识库",
      "description": "项目约定、决策记录与排查笔记",
      "metadata": {
        "team": "data"
      },
      "created_at": "2026-09-17T08:00:00Z",
      "updated_at": "2026-09-17T08:00:00Z"
    }
  ],
  "next_page": null
}

错误码

状态码错误码说明
400invalid_request_error参数、路径、limit 或分页游标非法
401InvalidApiKeyAPI Key 缺失、错误或失效
403permission_error身份或资源访问权限不足