diff --git a/docs/api-reference.rst b/docs/api-reference.rst
--- a/docs/api-reference.rst
+++ b/docs/api-reference.rst
@@ -13,6 +13,7 @@
    swh.deposit <swh-deposit/index>
    swh.fuse <swh-fuse/index>
    swh.graph <swh-graph/index>
+   swh.graphql <swh-graphql/index>
    swh.indexer <swh-indexer/index>
    swh.journal <swh-journal/index>
    swh.lister <swh-lister/index>
diff --git a/docs/index.rst b/docs/index.rst
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -105,6 +105,10 @@
     Fast, compressed, in-memory representation of the archive, with tooling to
     generate and query it.
 
+:ref:`swh.graphql <swh-graphql>`
+    GraphQL API to request archive data offering more precise and flexible queries
+    than the REST API.
+
 :ref:`swh.indexer <swh-indexer>`
     tools and workers used to crawl the content of the archive and extract
     derived information from any artifact stored in it