---
descriptions:
  reset_password:
    token: The `token` query parameter from the password reset URL.
    new_password: The new password to set for the user.
reference:
  curl:
    - key: reset_password
      id: reset_password
      url: /reference/authkit/password-reset/reset-password
      title: /user_management/password_reset/confirm
      type: POST
      parameters:
        - key: token
          type: string
          description: (reset_password.token)
        - key: new_password
          type: string
          description: (reset_password.new_password)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: user
              type: user
              description: (user.self)
  js:
    - key: resetPassword
      id: reset_password
      url: /reference/authkit/password-reset/reset-password
      title: userManagement.resetPassword()
      parameters:
        - key: token
          type: string
          description: (reset_password.token)
        - key: newPassword
          type: string
          description: (reset_password.new_password)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: user
              type: User
              description: (user.self)
  go:
    - key: ResetPassword
      id: reset_password
      url: /reference/authkit/password-reset/reset-password
      title: usermanagement.ResetPassword()
      parameters:
        - (ctx)
        - key: opts
          type: usermanagement.ResetPasswordOpts
          unwrap: true
          properties:
            - key: Token
              type: string
              description: (reset_password.token)
            - key: NewPassword
              type: string
              description: (reset_password.new_password)
      returns:
        - key: user
          type: UserResponse
          unwrap: true
          properties:
            - key: User
              type: User
              description: (user.self)
        - (err)
  python:
    - key: reset_password
      id: reset_password
      url: /reference/authkit/password-reset/reset-password
      title: user_management.reset_password()
      parameters:
        - key: token
          type: str
          description: (reset_password.token)
        - key: new_password
          type: str
          description: (reset_password.new_password)
      returns:
        - (User)
  php:
    - key: resetPassword
      id: reset_password
      url: /reference/authkit/password-reset/reset-password
      title: $userManagement->resetPassword()
      parameters:
        - key: token
          type: string
          description: (reset_password.token)
        - key: newPassword
          type: string
          description: (reset_password.new_password)
      returns:
        - key: user
          type: User
          description: (user.self)
  ruby:
    - key: reset_password
      id: reset_password
      url: /reference/authkit/password-reset/reset-password
      title: UserManagement.reset_password()
      parameters:
        - key: token
          type: String
          description: (reset_password.token)
        - key: new_password
          type: String
          description: (reset_password.new_password)
      returns:
        - (User)
  java:
    - key: resetPassword
      id: reset_password
      url: /reference/authkit/password-reset/reset-password
      title: userManagement.resetPassword()
      parameters:
        - key: token
          type: String
          description: (reset_password.token)
        - key: newPassword
          type: String
          description: (reset_password.new_password)
      returns:
        - (User)
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/authkit/password-reset/reset-password.mdx
---

## Reset the password

Sets a new password using the `token` query parameter from the link that the user received. Successfully resetting the password will verify a user's email, if it hasn't been verified yet.

<CodeBlock
  title="Request"
  referenceId="reset_password"
  file="reset-password-request"
/>