Skip to content

Request a password reset

POST
/account/forgot-password
curl --request POST \
--url https://acme.mykreezalid.com/front_api/v1/account/forgot-password \
--header 'Content-Type: application/json' \
--data '{ "email": "jane@example.com" }'

Emails the member a link to choose a new password. The link carries a single-use token, valid for one hour, to send to POST /account/reset-password. It only works for a visitor who is not signed in: a request that already carries a valid token or session is refused with 403.

Media typeapplication/json
object
email
required
string format: email

Example

jane@example.com

The reset email is sent.

Media typeapplication/json
object
code
integer
status
string
message
string

Example

{
"code": 200,
"status": "success",
"message": "Reset password request processed"
}

No account uses this email address.

Media typeapplication/json
object
code
integer
success
boolean
message
string

Example

{
"code": 401,
"success": false,
"message": "user not found"
}

The request already identifies a signed-in member.