列出工作空间事实

返回工作空间中跨项目和 Actor 的事实

GET /openapi/memorylake/api/v3/workspaces/{workspaceId}/memories/facts

按时间倒序返回工作空间中指定项目和/或 Actor 范围内的事实。每条事实都会标注其所属的项目或 Actor，因此您可以在整个工作空间范围内查询知识，无需分别调用每个项目或 Actor 的端点。

project_ids 或 actor_ids 至少需要提供一项，且两者合计最多只能引用 50 个不同的项目/Actor。

所需权限： project:mem_list

路径参数

workspaceId · string · required

工作空间 ID

查询参数

project_ids · array of strings

要包含的项目 ID；以逗号分隔（例如 proj-a,proj-b）

actor_ids · array of strings

要包含的 Actor ID；以逗号分隔（例如 actor-a,actor-b）

fact_fuzzy · string

按内容子串筛选事实

page_size · integer · default: "50"

每页返回的事实数量。范围：1–200。

continuation_token · string

上一次响应返回的令牌，用于获取下一页结果

两个项目的事实

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/workspaces/ws_abc123/memories/facts?project_ids=proj_def456,proj_ghi789' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/workspaces/ws_abc123/memories/facts?project_ids=proj_def456&actor_ids=act-a1b2c3d4e5f6' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/workspaces/ws_abc123/memories/facts?project_ids=proj_def456&fact_fuzzy=deadline' \
  -H 'Authorization: Bearer sk_xxxxxx'

响应

data · object

Show 事实分页列表

items · array

事实对象数组

Show 事实对象

id · string

事实唯一标识符

fact · string

事实文本

metadata · object

附加到事实的任意键值元数据

expired · boolean

事实是否已被遗忘

owner · object

该事实所属的项目或 Actor

Show 归属对象

type · string

归属类型：project 或 actor

id · string

归属 ID：当 type 为 project 时为项目 ID，为 actor 时为 Actor ID

expiration_date · string|null

计划的过期日期，如果事实不会过期则为 null

created_at · string

创建时间戳

updated_at · string

最后更新时间戳

continuation_token · string|null

用于获取下一页的令牌。当没有更多结果时为 null。

Success (200)

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "fact_8f3a1b2c4d5e",
        "fact": "Project deadline was moved to June 2025",
        "metadata": {
          "category": "planning"
        },
        "expired": false,
        "owner": {
          "type": "project",
          "id": "proj_def456"
        },
        "expiration_date": null,
        "created_at": "2025-06-10T14:30:00Z",
        "updated_at": "2025-06-10T14:30:00Z"
      },
      {
        "id": "fact_2d4e6f8a0b1c",
        "fact": "User prefers dark mode in all applications",
        "metadata": {
          "category": "preferences"
        },
        "expired": false,
        "owner": {
          "type": "actor",
          "id": "act-a1b2c3d4e5f6"
        },
        "expiration_date": null,
        "created_at": "2025-06-12T09:15:00Z",
        "updated_at": "2025-06-12T09:15:00Z"
      }
    ],
    "continuation_token": null
  }
}