列出工作空间事实 - MemoryLake 中国站

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'

{
  "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
  }
}

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

按时间倒序返回工作空间中指定项目和/或 Actor 范围内的事实。每条事实都会标注其所属的项目或 Actor，因此您可以在整个工作空间范围内查询知识，无需分别调用每个项目或 Actor 的端点。 project_ids 或 actor_ids 至少需要提供一项，且两者合计最多只能引用 50 个不同的项目/Actor。

所需权限： project:mem_list

路径参数

string

required

工作空间 ID

查询参数

array of strings

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

array of strings

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

string

按内容子串筛选事实

integer

default:"50"

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

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'

响应

object

Show 事实分页列表

array

事实对象数组

Show 事实对象

string

事实唯一标识符

string

事实文本

object

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

boolean

事实是否已被遗忘

object

该事实所属的项目或 Actor

Show 归属对象

string

归属类型：project 或 actor

string

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

string|null

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

string

创建时间戳

string

最后更新时间戳

string|null

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

{
  "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
  }
}

删除工作空间列出会话

​路径参数

​查询参数

​响应

路径参数

查询参数

响应