send_attempt is no longer optional

api/identity/definitions/request_email_validation.yaml

@@ -29,14 +29,13 @@ properties:
   send_attempt:
     type: integer
     description: |-
-      Optional. If specified, the server will only send an email if
+      The server will only send an email if the ``send_attempt``
-      the ``send_attempt`` is a number greater than the most recent
+      is a number greater than the most recent one which it has seen,
-      one which it has seen (or if it has never seen one), scoped
+      scoped to that ``email`` + ``client_secret`` pair. This is to
-      to that ``email`` + ``client_secret`` pair. This is to avoid
+      avoid repeatedly sending the same email in the case of request
-      repeatedly sending the same email in the case of request
+      retries between the POSTing user and the identity service.
-      retries between the POSTing user and the identity
+      The client should increment this value if they desire a new
-      service. The client should increment this value if they
+      email (e.g. a reminder) to be sent.
-      desire a new email (e.g. a reminder) to be sent.
     example: 1
   next_link:
     type: string

api/identity/definitions/request_msisdn_validation.yaml

@@ -36,10 +36,9 @@ properties:
   send_attempt:
     type: integer
     description: |-
-      Optional. If specified, the server will only send an SMS if
+      The server will only send an SMS if the ``send_attempt`` is a
-      the ``send_attempt`` is a number greater than the most recent
+      number greater than the most recent one which it has seen,
-      one which it has seen (or if it has never seen one), scoped
+      scoped to that ``country`` + ``phone_number`` + ``client_secret``
-      to that ``country`` + ``phone_number`` + ``client_secret``
       triple. This is to avoid repeatedly sending the same SMS in
       the case of request retries between the POSTing user and the
       identity service. The client should increment this value if