Adarsh-Me opened a new pull request, #500:
URL: https://github.com/apache/hugegraph-doc/pull/500
## What
`content/{en,cn}/docs/clients/restful-api/auth.md` claim "1.7.0+: Auth API
paths use GraphSpace format" and then document the group endpoints as
`/graphspaces/DEFAULT/auth/groups`. That spelling is wrong for the group API on
1.7.0 — which is exactly what
[apache/hugegraph#3019](https://github.com/apache/hugegraph/issues/3019)
reports as a 404.
Verified against source, not folklore:
| | tag `1.7.0` | `master` |
| --- | --- | --- |
| `UserAPI`/`TargetAPI`/`BelongAPI`/`AccessAPI`/`ManagerAPI`/`ProjectAPI` |
`@Path("graphspaces/{graphspace}/auth/…")` | same |
| `GroupAPI` | `@Path("/auth/groups")` | same |
| `GraphSpaceGroupAPI` | **file does not exist** |
`@Path("graphspaces/{graphspace}/auth/groups")` |
`GraphSpaceGroupAPI` arrived in
[apache/hugegraph#3096](https://github.com/apache/hugegraph/pull/3096)
(2026-07-21), and `ApplicationConfig.java:72` mounts it via
`packages("org.apache.hugegraph.api")`, so on master both spellings are live
but on 1.7.0 only `/auth/groups` is. The page also already contradicts itself:
`quickstart/client/hugegraph-client-python.md` says *"groups stay at the
server-level `/auth/groups`"*.
The change adds the exception to the version notice and a note at the head
of the group section, in both languages. Group URLs themselves are left as-is,
since this page documents the development version where the prefixed route does
exist.
## Checklist (from `contribution.md`)
- [ ] Strict production build — **not run here**: no `hugo` installed, Go is
1.26 vs the pinned 1.27.0, and `scripts/hugo.sh` additionally needs Python,
which this host does not have. CI is the build verification for this change.
- [x] `content/en/` and `content/cn/` both updated
- [x] No visual or navigation change, so no screenshots
- [x] Routes under `/docs/...` and `/cn/docs/...` unchanged (markdown
content only)
- [x] Related issue linked
## Question for maintainers
`release-1.7.0` carries the same prefixed group URLs, and that branch is
what the archived *1.7* version on the site serves — so a 1.7.0 user gets the
wrong spelling from the version they are actually running. Want a backport of
this note to `release-1.7.0`?
## AI use
Authored with an AI assistant (Qoder); every claim above was read out of the
referenced source files at the stated refs rather than inferred.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
