Merge pull request #3166 from matrix-org/travis/spec/msc2033-whoami-deviceid

Spec device_id on whoami

Author: turt2live

changelogs/client_server/newsfragments/3166.feature

@@ -0,0 +1 @@
+Add `device_id` to `/account/whoami` response as per [MSC2033](https://github.com/matrix-org/matrix-doc/pull/2033).

data/api/client-server/whoami.yaml

@@ -47,15 +47,23 @@ paths:
             The token belongs to a known user.
           examples:
             application/json: {
-              "user_id": "@joe:example.org"
+              "user_id": "@joe:example.org",
+              "device_id": "ABC1234"
             }
           schema:
             type: object
             required: ["user_id"]
             properties:
               user_id:
                 type: string
-                description: The user id that owns the access token.
+                description: The user ID that owns the access token.
+              device_id:
+                type: string
+                description: |-
+                  Device ID associated with the access token. If no device
+                  is associated with the access token (such as in the case
+                  of application services) then this field can be omitted.
+                  Otherwise this is required.
         401:
           description:
             The token is not recognised