diff --git a/docs/source/_static/rest-api.yml b/docs/source/_static/rest-api.yml
index 236ddb68..a4a5390e 100644
--- a/docs/source/_static/rest-api.yml
+++ b/docs/source/_static/rest-api.yml
@@ -1326,15 +1326,16 @@ components:
           description: The service that owns the token (undefined of owned by a user)
         roles:
           type: array
-          description: Deprecated in JupyterHub 2.3, always an empty list.
-            Tokens have 'scopes' starting from JupyterHub 2.3.
+          description:
+            Deprecated in JupyterHub 2.3, always an empty list. Tokens
+            have 'scopes' starting from JupyterHub 2.3.
           items:
             type: string
         scopes:
           type: array
-          description: List of scopes this token has been assigned.
-            New in JupyterHub 2.3. In JupyterHub 2.0-2.2,
-            tokens were assigned 'roles' insead of scopes.
+          description:
+            List of scopes this token has been assigned. New in JupyterHub
+            2.3. In JupyterHub 2.0-2.2, tokens were assigned 'roles' insead of scopes.
           items:
             type: string
         note: