> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memorylake.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 列出数据库记忆

> 返回项目中数据库记忆的分页列表

```
GET /openapi/memorylake/api/v3/workspaces/{workspaceId}/projects/{projectId}/memories/databases
```

返回项目中的数据库记忆。您可以使用延续令牌翻页。

列表结果不包含各记忆的 `instruction`。如需读取，请调用[获取数据库记忆](https://docs.memorylake.cn/features/memorylake/api-reference/database/database-memories/get-database-memory.md)。

> [!NOTE]
>
> **所需权限：** 项目上的 `project:dbset_read`。列表包含项目中的全部数据库记忆。

### 路径参数

**workspaceId** `string` *required*

项目所属的工作空间 ID

**projectId** `string` *required*

项目 ID

### 查询参数

**page\_size** `integer` (default: 20)

每页返回的数据库记忆数量，取值 1 到 100

**continuation\_token** `string`

上一次响应返回的令牌，用于获取下一页。请求第一页时不传。

```bash cURL theme={null}
curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/projects/proj-b93e8d95a8705bcc4ec42a65ba4cc7f8/memories/databases?page_size=20' \
  -H 'Authorization: Bearer sk_xxxxxx'
```

### 响应

**data** `object`

**数据库记忆分页列表**

**items** `array`

数据库记忆对象数组

**数据库记忆对象**

**id** `string`

数据库记忆标识符，请把它当作不透明字符串处理。

**name** `string`

显示名称

**status** `string`

处理状态：`pending`、`running`、`okay` 或 `error`。变为 `okay` 后记忆即可使用。

**error** `object`

失败详情。仅当 `status` 为 `error` 且上报了失败原因时返回。

**错误详情**

**code** `string`

错误码

**msg** `string`

错误信息

**project\_id** `string`

记忆所属项目的 ID

**db\_datasource\_id** `string`

该记忆读取的数据源

**analysis\_model\_id** `string`

该记忆从中获取知识的分析模型。未绑定时不返回该字段。

**instruction** `string`

列表结果中不返回。如需读取，请调用[获取数据库记忆](https://docs.memorylake.cn/features/memorylake/api-reference/database/database-memories/get-database-memory.md)。

**created\_at** `string`

创建时间戳

**continuation\_token** `string`

用于获取下一页结果的令牌。最后一页不返回该字段。

**total** `integer`

项目中所有页的数据库记忆总数

```json Success (200) theme={null}
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "doc-2e6a9c4f8b1d4a7e9c3b5d8f0a2c4e6b",
        "name": "Sales database",
        "status": "okay",
        "project_id": "proj-b93e8d95a8705bcc4ec42a65ba4cc7f8",
        "db_datasource_id": "dbds-4b8e2f6a1c9d4e7b8a3f5c2d6e9b1a7c",
        "analysis_model_id": "am-9d3f7b1e5a2c4d8f6b0e3a7c9d1f5b2e",
        "created_at": "2026-09-21T09:03:17.482Z"
      }
    ],
    "total": 1
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.