Skip to main content
POST
/
api
/
v1
/
recovery
/
init
curl -X POST https://api.gosentrix.io/api/v1/recovery/init \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]"
  }'

{
  "message": "Recovery email sent",
  "expires_in": 3600
}
Start the account recovery process to reset a forgotten password. 
curl -X POST https://api.gosentrix.io/api/v1/recovery/init \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]"
  }'

{
  "message": "Recovery email sent",
  "expires_in": 3600
}

​
Request Body

​
email
string
required
User email address

​
Response

​
message
string
Success message
​
expires_in
integer
Recovery token expiration time in seconds (1 hour)

​
Errors

​
400
object
Invalid email address
​
429
object
Rate limit exceeded (too many recovery requests)

​
Notes

  • Recovery email is sent to the user’s email address
  • Recovery tokens expire after 1 hour
  • Rate-limited to prevent abuse
  • See Recovery Verify for next steps