diff --git a/doc/rest_api.rst b/doc/rest_api.rst
index 70178848b..13cb23ef7 100644
--- a/doc/rest_api.rst
+++ b/doc/rest_api.rst
@@ -6,12 +6,18 @@ To ease the integration with external sources (software or other),
 Modoboa provides a REST API.
 
 Every installed instance comes with a ready-to-use API and a
-documentation. You will find them using the following url patterns:
+documentation. 
 
-* API: *http://<hostname>/api/v1/*
-* Documentation: *http://<hostname>/docs/api/*
+**You will find them using the following url patterns:**
 
-An `example <https://demo.modoboa.org/docs/api/>`_ of this
+* New API+Docs: *https://<hostname>/api/schema-v2/swagger/*
+* Old API: *http://<hostname>/api/v1/
+* (Old) Documentation: *http://<hostname>/docs/api/*
+
+**Examples:**
+
+* `new example <https://demo.modoboa.org/api/schema-v2/swagger/>`_
+* `old example <https://demo.modoboa.org/docs/api/>`_ 
 documentation is available on the official demo.
 
 Using this API requires an authentication and for now, only a token