operationId: userResetPassword
summary: Reset Password
security:
  - UserAuth: []
description: Reset the user password
tags: [User]
requestBody:
  content:
    application/json:
      schema:
        type: object
        required:
          - user_id
          - token
          - password
          - confirm_password
        properties:
          user_id:
            type: string
            format: uuid
            description: User ID, provided in URL
            example: 019e27f6-8898-7e4d-9dd7-93ce0e00cae0
          token:
            type: string
            format: uuid
            description: Unique user token, provided in URL
            example: 081e4b9b-37f4-46d8-97e3-303817399fea
          password:
            type: string
            description: New user password
            example: password123
          confirm_password:
            type: string
            description: Confirmation password
            example: password123

responses:
  "200":
    description: "Password reset (always returns '{success: true}')"
    content:
      application/json:
        schema:
          type: object
          properties:
            success:
              type: boolean
  "401":
    $ref: "#/components/responses/401"
  "403":
    $ref: "#/components/responses/403"
  "500":
    $ref: "#/components/responses/500"