[Bug] auth documentation need to be updated

[neoblackcap]

Bug Type (问题类型)

rest-api (结果不合预期)

Before submit

• 我已经确认现有的 Issues 与 FAQ 中没有相同 / 重复问题 (I have confirmed and searched that there are no similar problems in the historical issue and documents)

Environment (环境信息)

• Server Version: 1.7.0 (Apache Release Version)
• Backend: Hstore 1 nodes, SSD
• OS: xx CPUs, xx G RAM, Ubuntu 2x.x / CentOS 7.x
• Data Size: xx vertices, xx edges

Expected & Actual behavior (期望与实际表现)

文档中描述创建用户组的接口例子是
POST http://localhost:8080/graphspaces/DEFAULT/auth/groups
实际上调用会报404
只有使用
POST http://localhost:8080/auth/groups
才会正确创建用户组

Vertex/Edge example (问题点 / 边数据举例)

Schema [VertexLabel, EdgeLabel, IndexLabel] (元数据结构)

[dosubot]

Hi @neoblackcap! I'm Dosu and I’m helping the hugegraph team.

This is a confirmed documentation issue. The correct endpoint in version 1.7.0 is indeed POST http://localhost:8080/auth/groups, as you've found.

The change was introduced in PR #2899 ("fix(server): remove graph path in auth api path"), which simplified all auth API paths by removing the /graphspaces/{graphspace}/graphs/{graph}/ prefix [1]. The GroupAPI class now uses @Path("/auth/groups") directly [2].

This applies to all auth endpoints — groups, users, targets, belongs, access, and projects all follow the simplified /auth/... pattern now. The documentation referencing /graphspaces/DEFAULT/auth/groups is outdated and needs to be updated to reflect this change.

非常感谢你指出这个问题, 这是文档没有及时同步造成的

你可以结合最新的代码, 在 website 仓库提交一个 PR 修复它和相关 API 么?

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.

[neoblackcap]

@dosu 说是/auth/...都删除掉了前缀，但是在1.7.0的系统中，我只发现了/auth/groups是这样的情况，其他的鉴权管理接口还是保留前缀/graphspaces/DEFAULT/

[dosubot]

感谢指正，你说得对。我之前的回复有误。

经过进一步确认，在 1.7.0 中确实存在路径不一致的情况：

• GroupAPI 使用 @Path("/auth/groups")，不需要 graphspace 前缀 [1]
• UserAPI 使用 @Path("graphspaces/{graphspace}/auth/users") [2]
• AccessAPI 使用 @Path("graphspaces/{graphspace}/auth/accesses") [3]
• BelongAPI 使用 @Path("graphspaces/{graphspace}/auth/belongs") [4]
• TargetAPI 使用 @Path("graphspaces/{graphspace}/auth/targets") [5]
• ProjectAPI 使用 @Path("graphspaces/{graphspace}/auth/projects") [6]

这是 PR #2899 的改动结果——该 PR 将所有 auth API 中的 /graphs/{graph}/ 段移除了，但对 GroupAPI 做了更激进的简化（同时移除了 graphspace 参数），而其他 auth API 仅移除了 graph 参数，仍保留了 /graphspaces/{graphspace}/ 前缀。

所以目前的情况是：

• /auth/groups → 直接调用即可
• /graphspaces/DEFAULT/auth/users、/graphspaces/DEFAULT/auth/targets 等 → 仍需要 graphspace 前缀

这确实是一个一致性问题，GroupAPI 的路径风格和其他 auth 端点不统一。文档需要针对每个端点分别修正其正确路径。

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.