Reset password with token

POSThttps://app.speybooks.com/api/v1/auth/reset-password

Set a new password using the token from the reset link. The token must be unused and unexpired and the account active. The new password must be at least 8 characters and contain at least one letter and one number. The change is applied atomically and the link is marked used so it cannot be replayed. An expired or used link is rejected and the user must request a new one.

Body parameters

passwordstringrequired

min length: 8

tokenstringrequired

The 64-character reset token from the email link.

Response

200Password reset successfully. The user can now log in with their new password.

Show response fields

messagestring

Confirmation message.

Error codes

400Invalid, expired, or already-used reset token, or password does not meet requirements.

429Rate limit exceeded. Try again later.

RequestPOST/v1/auth/reset-passwordcurl

curl -X POST https://api.speybooks.com/v1/auth/reset-password \
  -H "Content-Type: application/json" \
  -d '{"token": "<token from the reset link>", "password": "<new password>"}'

Response200

{
  "success": true,
  "message": "Your password has been reset successfully."
}