Password Reset API v1.0

1. Request Reset Code

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

Success Response

{
  "success": true,
  "code": "reset_code_sent",
  "userId": "user_123",
  "message": "Reset code sent to email"
}

Error Response

{
  "success": false,
  "code": "user_not_found",
  "message": "No account found with this email"
}

2. Verify Reset Code

curl -X POST https://api.wecompleteapp.com/api/auth/reset \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_123",
    "code": "12345"
  }'

Success Response

{
  "success": true,
  "code": "code_valid",
  "valid": true,
  "message": "Reset code verified"
}

Error Response

{
  "success": false,
  "code": "invalid_code",
  "message": "Invalid or expired reset code"
}

3. Update Password

curl -X POST https://api.wecompleteapp.com/api/auth/reset \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_123",
    "newPassword": "NewSecurePassword123!"
  }'

Success Response

{
  "success": true,
  "code": "password_updated",
  "token": "new-long-term-token",
  "userId": "user_123",
  "message": "Password updated successfully"
}