Feature Request: Implement `/api/v2/graph/list-all` endpoint to list all graphs

[zkey-wxj]

Feature Request: List-All Graphs API Endpoint

希望实现一个新的 API 接口 /api/v2/graph/list-all，用于列出当前系统中所有已存在的 graph。

背景与需求

目前 OpenZep 支持对指定 graph 进行操作（如获取 node/edge/统计信息）。但实际应用时，用户常常需要快速获取所有已创建的 graph 信息，比如：

• 管理后台一键展示所有知识图谱
• 实现分页浏览、管理与权限分配

建议实现方式

• 新增 GET /api/v2/graph/list-all 路由
• 返回结果包括每个 graph 的 ID、名称、创建时间等基础元数据
• 支持分页（可选）和简单筛选

参考

许多知识图谱/图数据库（如 Neo4j Workspace、Nebula Graph Studio 等）均提供类似的"列出全部图谱"接口，便于管理与运维。

希望考虑实现，非常感谢！

[N1nEmAn]

Implemented on main — GET /api/v2/graph/list-all is live (17c91eb, b4452cf).

Returns every graph with graph_id, name, node_count, edge_count, and created_at, plus pagination via ?limit= (default 50, max 500) and ?offset=.

Implementation note worth flagging: in the current graphiti-core (0.29.x), driver.clone(database=...) is a no-op — all graphs share a single database, partitioned by the group_id property on nodes/edges. So this endpoint aggregates via GROUP BY n.group_id rather than enumerating Neo4j databases (the first version did that and both missed real graphs and leaked unrelated database names on shared instances). Two queries total, no N+1. Results are globally sorted by created_at then paginated.

curl -H "Authorization: Bearer $API_KEY" \
  "http://localhost:8000/api/v2/graph/list-all?limit=50"

Thanks for the request — it surfaced a real correctness issue in how graphs are modeled.

[N1nEmAn]

Hi @zkey-wxj — the endpoint is implemented!

GET /api/v2/graph/list-all returns each graph's id, name, node_count, edge_count, and created_at, with limit/offset pagination (default limit 50, max 500).

Implementation note: All graphs share one Neo4j database, partitioned by group_id. Listing is a single GROUP BY n.group_id aggregation — 2 queries total, sorted by created_at desc.

The endpoint has been added to the README API table. Commits 17c91eb and b4452cf (correction) on main.

To verify:

git pull
docker compose up -d --build
curl -H "Authorization: Bearer <your_api_key>" http://localhost:8000/api/v2/graph/list-all
# optional pagination
curl -H "Authorization: Bearer <your_api_key>" "http://localhost:8000/api/v2/graph/list-all?limit=10&offset=0"