diff --git a/api/readers.yml b/api/readers.yml
index f0ca9fb2b4..39d88e3457 100644
--- a/api/readers.yml
+++ b/api/readers.yml
@@ -99,9 +99,10 @@ components:
   parameters:
     Authorization:
       name: Authorization
-      description: Thing or User access token. 
-      For thing access use "Authorization: Thing <thing_key>"
-      For user access use "Authorization: Bearer <user_token>"
+      description: | 
+        Thing or User access token: 
+        * For thing access use "Authorization: Thing <thing_key>"
+        * For user access use "Authorization: Bearer <user_token>"
       in: header
       schema:
         type: string