Clarify that id_access_token is optional for r0.5

api/client-server/administrative_contact.yaml

@@ -112,7 +112,10 @@ paths:
                     description: The identity server to use.
                   id_access_token:
                     type: string
-                    description: An access token previously registered with the identity server.
+                    description: |-
+                      An access token previously registered with the identity server. Servers
+                      can treat this as optional to distinguish between r0.5-compatible clients
+                      and this specification version.
                   sid:
                     type: string
                     description: The session identifier given by the identity server.

api/client-server/create_room.yaml

@@ -141,7 +141,10 @@ paths:
                       description: The hostname+port of the identity server which should be used for third party identifier lookups.
                     id_access_token:
                       type: string
-                      description: An access token previously registered with the identity server.
+                      description: |-
+                        An access token previously registered with the identity server. Servers
+                        can treat this as optional to distinguish between r0.5-compatible clients
+                        and this specification version.
                     medium:
                       type: string
                       # TODO: Link to Identity Service spec when it eixsts

api/client-server/definitions/request_email_validation.yaml

@@ -25,5 +25,8 @@ allOf:
       example: "id.example.com"
     id_access_token:
       type: string
-      description: An access token previously registered with the identity server.
+      description: |-
+        An access token previously registered with the identity server. Servers
+        can treat this as optional to distinguish between r0.5-compatible clients
+        and this specification version.
   required: ["id_server", "id_access_token"]

api/client-server/definitions/request_msisdn_validation.yaml

@@ -25,5 +25,8 @@ allOf:
       example: "id.example.com"
     id_access_token:
       type: string
-      description: An access token previously registered with the identity server.
+      description: |-
+        An access token previously registered with the identity server. Servers
+        can treat this as optional to distinguish between r0.5-compatible clients
+        and this specification version.
   required: ["id_server", "id_access_token"]

api/client-server/third_party_membership.yaml

@@ -102,7 +102,10 @@ paths:
                 description: The hostname+port of the identity server which should be used for third party identifier lookups.
               id_access_token:
                 type: string
-                description: An access token previously registered with the identity server.
+                description: |-
+                  An access token previously registered with the identity server. Servers
+                  can treat this as optional to distinguish between r0.5-compatible clients
+                  and this specification version.
               medium:
                 type: string
                 # TODO: Link to Identity Service spec when it eixsts