Update comment to reflect new change in api token creation (#154)

* DEV-37012: Add docs for error when updating a user with non-existent roles (#150)

* docs: Add docs for error when updating a user with non-existent roles

* docs: Move 400 response example to the update roles request

---------

Co-authored-by: Sam Ford <sam.ford@acrolinx.com>

* Update comment to reflect new change in api token creation

---------

Co-authored-by: Sam Ford <sam.ford@acrolinx.com>

apiary.apib

@@ -4229,6 +4229,8 @@ Typical use cases for this API:
             }
         }
 
++ Response 403 (application/json)
+
         // when the creator or receiver of the token is the built-in `admin`
         {
             "links": {},
@@ -4241,7 +4243,9 @@ Typical use cases for this API:
             }
         }
 
-        // when the user tries to create a token for another user with more elevated roles
++ Response 403 (application/json)
+
+        // when the user tries to create a token for a Super Administrator user, when they are not a Super Administrator themselves
         {
             "links": {},
             "error": {