readthedocs · humitos · Oct 30, 2019 · Sep 11, 2019 · Sep 11, 2019 · Sep 11, 2019
diff --git a/docs/api/index.rst b/docs/api/index.rst
@@ -11,3 +11,4 @@ from Read the Docs.
     :maxdepth: 3
 
     v2
+    v3
diff --git a/docs/api/v2.rst b/docs/api/v2.rst
@@ -1,22 +1,22 @@
-API v2
-======
+API v2 (deprecated)
+===================
 
 The Read the Docs API uses :abbr:`REST (Representational State Transfer)`.
 JSON is returned by all API responses including errors
 and HTTP response status codes are to designate success and failure.
 
 .. note::
 
-    A newer API v3 is in early development stages.
+    A newer and better API v3 is ready to use.
     Some improvements coming in v3 are:
 
-    * Search API
-    * Write access
-    * Simpler URLs which use slugs instead of numeric IDs
+    * Simpler URLs which use slugs
+    * Token based authentication
+    * Import a new project
+    * Activate a version
     * Improved error reporting
 
-    If there are features you would like in v3, please get in touch
-    in the `issue tracker <https://github.com/readthedocs/readthedocs.org/issues>`_.
+    See its full documentation at :doc:`/api/v3`.
 
 
 Authentication and authorization
Original file line number	Diff line number	Diff line change
Expand Up		@@ -11,3 +11,4 @@ from Read the Docs.
		:maxdepth: 3

		v2
		v3