/auth/{dbname}/reset_password:
  post:
    tags:
      - auth
    summary: Completes a password reset
    description: Completes a password reset request for a user account with a code sent to the email address by the `forgot_password` endpoint
    parameters:
      - name: dbname
        in: path
        description: name of the database
        required: true
        schema:
          type: string
          example: mydb
    requestBody:
      description: verification object
      content:
        'application/json':
          schema:
            type: object
            properties:
              code:
                type: string
                description: Password reset code that was sent to the user's email address
              password:
                type: string
                description: New password to set on the account
            required:
              - code
              - password
    responses:
      200:
        description: If the password reset is successful, returns the string `"OK"`
        content:
          'text/plain':
            schema:
              type: 'string'
              value: OK
              description: The string `"OK"`
      400:
        description: Returns a `"401 Bad Request"` if the code sent with the request is invalid, or the new password doesn't meet the requirements
        content:
          'application/json':
            schema:
              $ref: '#/components/schemas/Error'
              example:
                code: invalid_code
                message: Invalid token
      500:
        description: An unexpected error occurred
        content:
          'application/json':
            schema:
              $ref: '#/components/schemas/UnexpectedError'