             init   : required
         password:
             init   : required
-            desc   : '6 characters or longer'
+            desc   : 'must be between 6 and 64 characters in length'
         agreed_to_terms:
             init   : required
             desc   : 'must be true for request to succeed'

    error         : false

# client --> hub
API message
    event             : 'change_email_address'
    id                : undefined
    account_id        : required
    old_email_address : ""        # ignored -- deprecated
    new_email_address : required
    password          : ""

# hub --> client
message

    error          : undefined

# client --> hub: "please send a password reset email"
API message2
    event         : "forgot_password"
    fields:
        id:
            init  : undefined
            desc  : 'A unique UUID for the query'
        email_address:
            init  : required
            desc  : 'email address for account requesting password reset'
    desc          : """
Given the email address of an existing account, send password reset email.

Example:
  curl -u sk_abcdefQWERTY090900000000: -d email_address=... https://cocalc.com/api/v1/forgot_password
  ==> {"event":"forgot_password_response","id":"26ed294b-922b-47e1-8f3f-1e54d8c8e558","error":false}
"""

# hub --> client  "a password reset email was sent, or there was an error"
message
