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

# Criar Questões de Provas

> Este endpoint permite a criação de questões para provas, recebendo os dados necessários para configurar cada questão.

## Parâmetros

<ParamField body="school" type="number[]" required>
  Array de IDs das escolas onde as questões serão vinculadas.
</ParamField>

<ParamField body="theme" type="string">
  ID do tema ao qual a questão será vinculada. O tema deve pertencer à mesma escola onde a questão está sendo criada.
</ParamField>

<ParamField body="group" type="number[]" required>
  Nome ou ID do grupo ao qual a questão será vinculada.
</ParamField>

<ParamField body="subgroup" type="number[]">
  Nome ou ID do subgrupo ao qual a questão será vinculada. O subgrupo deve ter relação com o grupo informado.
</ParamField>

<ParamField body="specialty" type="number[]">
  Nome ou ID da especialidade à qual a questão será vinculada. A especialidade deve ter relação com o subgrupo informado.
</ParamField>

<ParamField body="questions" type="array" required>
  <ParamField body="support_text" type="string">
    Texto de apoio exibido durante a execução da prova.
  </ParamField>

  <ParamField body="explanation_text" type="string">
    Texto explicativo da resposta, exibido após a finalização da prova.
  </ParamField>

  <ParamField body="tags" type="string[]">
    Lista de tags associadas à questão.
  </ParamField>

  <ParamField body="difficulty" type="number">
    Nível de dificuldade da questão:
    1 = Fácil
    2 = Médio
    3 = Difícil
  </ParamField>

  <ParamField body="question_text" type="string" required>
    Enunciado da questão.
  </ParamField>

  <ParamField body="options" type="array">
    <ParamField body="text" type="string">
      Texto das alternativas da questão. Se este campo for vazio, a questão será cadastrada como discursiva. Para questões de múltipla escolha, é obrigatório o envio de no mínimo duas alternativas.
    </ParamField>

    <ParamField body="is_correct" type="boolean">
      Parâmetro que define se a alternativa é considerada correta.

      False = Incorreta
      True = Correta
    </ParamField>
  </ParamField>
</ParamField>

## Segurança

Para acessar este endpoint, é necessário enviar um token de acesso válido no cabeçalho de autorização (**Authorization**) da requisição.\
A API conta com medidas adicionais de segurança para garantir a proteção dos dados dos usuários.