POST /api/v1/auth/send-reset-token

Initiate password reset process by sending a reset token to the user's email address. This is the first step in the password reset flow.

application/json

Body Required

Email address to send reset token to

  • email string Required

Responses

  • 200 application/json

    Reset token sent successfully to email

    Hide response attributes Show response attributes object
    • message string Required

      Response message

    • success boolean Required
  • 400 application/json

    Invalid email format or validation errors

  • 404 application/json

    User with provided email not found

POST /api/v1/auth/send-reset-token
curl \
 --request POST 'https://api.echoplain.social/api/v1/auth/send-reset-token' \
 --header "Content-Type: application/json" \
 --data '{"email":"user@university.edu"}'
Request example
Request password reset for user email
{
  "email": "user@university.edu"
}
Response examples (200)
{
  "message": "Password reset token sent to your email",
  "success": true
}
Response examples (400)
{
  "error": "Bad Request",
  "message": [
    "email must be an email"
  ],
  "statusCode": 400
}
Response examples (404)
{
  "error": "Not Found",
  "message": "User not found",
  "statusCode": 404
}