NHnhost
user

Request password reset

Changed on

Request a password reset for a user account. An email with a verification link will be sent to the user's email address to complete the password reset process.

post/user/password/reset

Request

  • Base URL
    https://{subdomain}.auth.{region}.nhost.run/v1
  • URL
    https://{subdomain}.auth.{region}.nhost.run/v1/user/password/reset
  • Auth
    none declared

Request body

emailstring email required

A valid email

codeChallengestring

PKCE code challenge (S256). When provided, the verification redirect will contain an authorization code instead of a refresh token.

Example request

{
  "email": "john.smith@nhost.io",
  "options": {
    "redirectTo": "https://my-app.com/catch-redirection"
  }
}

Response

Password reset requested

'OK' required

Changes

  • 0fc5fd589dbfRevision changes
    • warning

      added the new otp-too-many-attempts enum value to the response property for the response status

  • b39086c84b43Revision changes
    • warning

      added the new user-already-exists enum value to the response property for the response status

    • info

      removed the email-already-in-use enum value from the response property for the response status