> ## 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.

# Iniciar Desafio de MFA

> Use este endpoint para solicitar um novo código de verificação MFA enviado por e-mail ou SMS. Isso é útil quando o usuário precisa de um novo código ou deseja alternar para um método de MFA diferente.

Requer um `mfaToken` válido obtido do endpoint de token de acesso.




## OpenAPI

````yaml pt/openapi/v3-current/AM-auth.yaml post /v1/login/mfa/challenge
openapi: 3.1.0
info:
  title: Plugin de Autenticação
  description: ''
  version: 2.6.7
servers:
  - url: https://auth.sandbox.lerian.net
security: []
tags:
  - name: API de Autenticação
  - name: API de MFA
  - name: API de Informações do Usuário
  - name: API de Autorização
paths:
  /v1/login/mfa/challenge:
    post:
      tags:
        - API de MFA
      summary: Iniciar Desafio de MFA
      description: >
        Use este endpoint para solicitar um novo código de verificação MFA
        enviado por e-mail ou SMS. Isso é útil quando o usuário precisa de um
        novo código ou deseja alternar para um método de MFA diferente.


        Requer um `mfaToken` válido obtido do endpoint de token de acesso.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MFAChallengeInput'
            example:
              mfaToken: eyJhbGciOiJIUzI1NiJ9...
              mfaType: email
      responses:
        '200':
          description: >-
            O desafio de MFA foi iniciado. Um código de verificação foi enviado
            pelo método solicitado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Confirmação de que o desafio foi iniciado.
              example:
                message: MFA challenge initiated
          headers: {}
        '400':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
              examples:
                Error0001:
                  $ref: '#/components/examples/Error0001'
                Error0009:
                  $ref: '#/components/examples/Error0009'
          headers: {}
        '401':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
              examples:
                Error0020:
                  $ref: '#/components/examples/Error0020'
          headers: {}
        '429':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
              examples:
                Error0018:
                  $ref: '#/components/examples/Error0018'
          headers: {}
        '500':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
              examples:
                Error0005:
                  $ref: '#/components/examples/Error0005'
          headers: {}
      security: []
components:
  schemas:
    MFAChallengeInput:
      description: >-
        Informações usadas para solicitar um novo código de verificação MFA por
        e-mail ou SMS.
      type: object
      required:
        - mfaToken
        - mfaType
      properties:
        mfaToken:
          type: string
          description: O token MFA temporário recebido do endpoint de token de acesso.
        mfaType:
          type: string
          enum:
            - app
            - email
            - sms
          description: O método de MFA a ser usado para o desafio.
    ErrorMessage:
      description: A mensagem de erro da resposta.
      type: object
      properties:
        code:
          type: string
          description: Um identificador único e estável para o erro.
        title:
          type: string
          description: Um breve resumo do problema.
        message:
          type: string
          description: Orientação detalhada para resolver o erro.
  examples:
    Error0001:
      summary: Missing Fields in Request
      value:
        code: AUT-0001
        title: Missing Fields in Request
        message: >-
          Your request is missing one or more required fields. Please refer to
          the documentation to ensure all necessary fields are included in your
          request.
    Error0009:
      summary: Bad Request
      value:
        code: AUT-0009
        title: Bad Request
        message: >-
          The server could not understand the request due to malformed syntax.
          Please check the listed fields and try again.
    Error0020:
      summary: Invalid MFA Token
      value:
        code: AUT-0020
        title: Invalid MFA Token
        message: >-
          The provided MFA token is invalid or malformed. Please use the token
          received from the access token endpoint.
    Error0018:
      summary: MFA Max Attempts Reached
      value:
        code: AUT-0018
        title: MFA Max Attempts Reached
        message: >-
          The maximum number of MFA verification attempts has been reached.
          Please restart the login process.
    Error0005:
      summary: Internal Server Error
      value:
        code: AUT-0005
        title: Internal Server Error
        message: >-
          The server encountered an unexpected error. Please try again later or
          contact support.

````