Merge pull request #2057 from matrix-org/anoa/clarify_email_sending

Clarify what the client should receiving on email resending

api/identity/definitions/request_email_validation.yaml

@@ -39,7 +39,8 @@ properties:
       avoid repeatedly sending the same email in the case of request
       retries between the POSTing user and the identity server.
       The client should increment this value if they desire a new
-      email (e.g. a reminder) to be sent.
+      email (e.g. a reminder) to be sent. If they do not, the server
+      should respond with success but not resend the email.
     example: 1
   next_link:
     type: string

changelogs/identity_service/newsfragments/2057.clarification

@@ -0,0 +1 @@
+Clarify what the client should receive upon sending an identical email validation request multiple times.