diff --git a/docs/rest-api.yml b/docs/rest-api.yml
index 8c536dd6..06bfba1a 100644
--- a/docs/rest-api.yml
+++ b/docs/rest-api.yml
@@ -3,7 +3,7 @@ swagger: '2.0'
 info:
   title: JupyterHub
   description: The REST API for JupyterHub
-  version: 0.7.0
+  version: 0.8.0dev
   license:
     name: BSD-3-Clause
 schemes:
@@ -215,6 +215,13 @@ paths:
       responses:
         '200':
           description: Sets a cookie granting the requesting administrator access to the user's notebook server
+  /user:
+    summary: Return authenticated user's model
+    description:
+    parameters:
+    responses:
+      '200':
+        description: The authenticated user's model is returned.
   /groups:
     get:
       summary: List groups
@@ -435,6 +442,10 @@ paths:
           description: The user identified by the cookie
           schema:
             $ref: '#/definitions/User'
+  /oath2/authorize:
+
+  /oath2/token:
+
   /shutdown:
     post:
       summary: Shutdown the Hub