diff --git a/docs/apis/http/graph/_index.md b/docs/apis/http/graph/_index.md
index 1bf37998a1..cde6f929dc 100644
--- a/docs/apis/http/graph/_index.md
+++ b/docs/apis/http/graph/_index.md
@@ -61,6 +61,12 @@ GET https://ocis.url/graph/v1.0/drives?$filter=driveType eq 'project'
 ```
 For more information about OData query options please check the [API specification](https://github.com/owncloud/libre-graph-api) and the provided examples.
 
+### Authorization
+
+For development purposes the examples in the developer documentation use Basic Auth. It is disabled by default and should only be enabled by setting `PROXY_ENABLE_BASIC_AUTH` in [the proxy](../../../services/proxy/configuration/#environment-variables) for development or test instances.
+
+To authenticate with a Bearer token or OpenID Connect access token replace the `-u user:password` Basic Auth option of curl with a `-H 'Authorization: Bearer <token>'` header. A `<token>` can be obtained by copying it from a request in the browser, although it will time out within minutes. To automatically refresh the OpenID Connect access token an ssh-agent like solution like [oidc-agent](https://github.com/indigo-dc/oidc-agent) should be used. The graph endpoints that support a preconfigured token can be found in the [API specification](https://github.com/owncloud/libre-graph-api)
+
 ## Resources
 
 {{< toc-tree >}}
diff --git a/docs/apis/http/graph/groups.md b/docs/apis/http/graph/groups.md
index 0a94422888..ca2daf45a5 100644
--- a/docs/apis/http/graph/groups.md
+++ b/docs/apis/http/graph/groups.md
@@ -2,8 +2,8 @@
 title: Groups
 weight: 40
 geekdocRepo: https://github.com/owncloud/ocis
-geekdocEditPath: edit/master/docs/services/graph
-geekdocFilePath: users.md
+geekdocEditPath: edit/master/docs/apis/http/graph
+geekdocFilePath: groups.md
 ---
 
 {{< toc >}}
diff --git a/docs/apis/http/graph/spaces.md b/docs/apis/http/graph/spaces.md
index 474045761e..bdf3a031d5 100644
--- a/docs/apis/http/graph/spaces.md
+++ b/docs/apis/http/graph/spaces.md
@@ -2,7 +2,7 @@
 title: Spaces
 weight: 20
 geekdocRepo: https://github.com/owncloud/ocis
-geekdocEditPath: edit/master/docs/services/graph
+geekdocEditPath: edit/master/docs/apis/http/graph
 geekdocFilePath: spaces.md
 ---
 
diff --git a/docs/apis/http/graph/users.md b/docs/apis/http/graph/users.md
index 745b2d9be4..84cb5d0eb5 100644
--- a/docs/apis/http/graph/users.md
+++ b/docs/apis/http/graph/users.md
@@ -2,7 +2,7 @@
 title: Users
 weight: 30
 geekdocRepo: https://github.com/owncloud/ocis
-geekdocEditPath: edit/master/docs/services/graph
+geekdocEditPath: edit/master/docs/apis/http/graph
 geekdocFilePath: users.md
 ---