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

> Crie novas trilhas na sua instituição.

## Parâmetros

<ParamField body="trail_title" type="string" required>
  Título da trilha. Deve ter no máximo 255 caracteres.
</ParamField>

<ParamField body="trail_title" type="string" required>
  Título da trilha. Deve ter no máximo 255 caracteres.
</ParamField>

<ParamField body="trail_description" type="string" required>
  Descrição da trilha.
</ParamField>

<ParamField body="group" type="array" required>
  Array de grupos por nome, separados por vírgula.
</ParamField>

<ParamField body="school" type="array" required>
  Subdomínios das escolas onde a trilha será disponibilizada. Array com valores separados por vírgula.
</ParamField>

<ParamField body="subgroup" type="array">
  Array de subgrupos por nome, separados por vírgula.
</ParamField>

<ParamField body="specialty" type="array">
  Array de especialidades por nome, separados por vírgula.
</ParamField>

<ParamField body="trail_start_date" type="date">
  Data de início da trilha. Deve ser igual ou posterior à data atual.
</ParamField>

<ParamField body="trail_end_date" type="date">
  Data de término da trilha. Deve ser posterior à trail\_start\_date.
</ParamField>

<ParamField body="workload" type="int">
  Carga horária. Deve ser maior que 0.
</ParamField>

<ParamField body="certificate" type="string">
  Certificado concedido na trilha. Deve ter no máximo 255 caracteres para o nome ou informar o ID do certificado.
</ParamField>

<ParamField body="progression_criteria" type="int">
  Critério de progressão. Deve ser "0" sem critério, "1" sequencial, "2" por período ou "3" por desempenho.
</ParamField>

<ParamField body="volume" type="int">
  Número inteiro que representa o volume. Deve ser entre 1 e 10.
</ParamField>

<ParamField body="tag" type="array">
  Tags separadas por vírgula.
</ParamField>

<ParamField body="trail_view" type="int">
  Número que representa a visualização da trilha. Deve ser "0" para visual padrão ou "1" para visual gamificado.
</ParamField>

<ParamField body="available_content" type="string" required>
  Conteúdos da trilha separados por vírgula. Cada item deve ser o nome ou ID do conteúdo.
</ParamField>

<ParamField body="available_content_type" type="array[int]" required>
  Tipo de conteúdo incluso em available\_content, separados por vírgula. Cada item deve ser "0" para tipo curso ou "1" para tipo conteúdo, sendo cada dígito associado de maneira posicional ao seu respectivo conteúdo em available\_content. Exemplo: para os conteúdos Curso 01, Conteúdo 01, seus tipos devem ser declarados como 0,1.
</ParamField>

<ParamField body="cover" type="string">
  URL da imagem de capa. Deve ser um dos formatos 'jpeg', 'png' ou 'jpg' e ter no máximo 4096 kb. Caso não seja informado, a logo da instituição será utilizada.
</ParamField>

<ParamField body="days_to_release" type="int">
  Dias para liberar o próximo conteúdo. Obrigatório se progression\_criteria for "2". Deve ser maior que 1.
</ParamField>

<ParamField body="trail_is_exclusive" type="boolean">
  Campo para definir se a trilha é exclusiva.
</ParamField>

<ParamField body="class_ids" type="array[int]">
  Campo para definir as turmas que serão vinculadas à trilha. Caso o campo "trail\_is\_exclusive" seja verdadeiro e "class\_ids" não seja informado, as turmas serão criadas dentro das escolas informadas no campo "school". Exemplo de uso: "class\_ids": class\_id1,class\_id2,class\_id3
</ParamField>

## Segurança

Para acessar este endpoint, é necessário enviar um token de acesso válido através do cabeçalho de autorização (Authorization) da requisição. Além disso, a API é protegida por outras medidas de segurança para garantir a proteção dos dados dos usuários.