> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Reset a password with a verification code

> Sets a new password using the code delivered by the send-code endpoint. PUBLIC — no authentication required. Every refusal (unknown email, wrong or expired code, rejected password) returns the same error code.



## OpenAPI

````yaml /es/openapi/v3-current/AM-identity.yaml post /v1/users/forgot-password/reset
openapi: 3.0.1
info:
  contact: {}
  description: This is a swagger documentation for the Identity API
  termsOfService: http://swagger.io/terms/
  title: Identity API
  version: 1.0.0
servers:
  - url: //localhost:4001/
security: []
paths:
  /v1/users/forgot-password/reset:
    post:
      tags:
        - Users
      summary: Reset a password with a verification code
      description: >-
        Sets a new password using the code delivered by the send-code endpoint.
        PUBLIC — no authentication required. Every refusal (unknown email, wrong
        or expired code, rejected password) returns the same error code.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ForgotPasswordResetInput'
        description: Forgot Password Reset
        required: true
      responses:
        '204':
          content: {}
          description: No Content
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/pkg.HTTPError'
          description: Bad Request
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/pkg.HTTPError'
          description: Internal Server Error
components:
  schemas:
    ForgotPasswordResetInput:
      description: ForgotPasswordResetInput payload
      example:
        code: '123456'
        newPassword: newPassw0rd!
        email: user@acme.com
      properties:
        code:
          description: Six-digit verification code delivered by the send-code endpoint.
          example: '123456'
          type: string
        email:
          description: Email address of the account being reset.
          example: user@acme.com
          type: string
        newPassword:
          description: New password to set on the account.
          example: newPassw0rd!
          type: string
      required:
        - code
        - email
        - newPassword
      type: object
    pkg.HTTPError:
      properties:
        code:
          type: string
        entityType:
          type: string
        err:
          type: object
        message:
          type: string
        title:
          type: string
      type: object

````