Skip to content
Last updated

🔨 In Development — This section is still being developed and may change.
**POST** `/v1/auth/password/reset` - Initiate a password reset flow by requesting a reset link or code to be sent to the user's email address. This endpoint is safe to call for unknown emails and always responds generically to avoid information disclosure.
POSThttps://api.freddy.aitronos.com/v1/auth/password/reset

Sends a password reset email with a secure, time-limited token to the user's email address if the account exists. The response is intentionally generic to prevent email enumeration attacks.

Request Body

email string required

User's email address for password reset.


Returns

A Password Reset Response object containing confirmation message for the reset request.

success boolean

Indicates if the password reset request was processed successfully. Always true for valid requests.

message string

Generic success message. The same message is returned regardless of whether the email exists to prevent email enumeration attacks.

Bash
curl -X POST https://api.freddy.aitronos.com/v1/auth/password/reset \
-H "Content-Type: application/json" \
-d '{
  "email": "user@example.com"
}'