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

# Editar Trilhas

> Edite as trilhas criadas previamente na sua instituição

## Parâmetros

<ParamField path="Id da trilha" type="string" required>
  Identificador da trilha que deseja editar
</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="clean_filters" type="string">
  0 ou null = manter os filtros registrados (padrão) — 1 = limpar filtros.
</ParamField>

<ParamField body="group" type="array">
  Array com os nomes dos grupos, separados por vírgula.
</ParamField>

<ParamField body="subgroup" type="array">
  Array com os nomes dos subgrupos, separados por vírgula.
</ParamField>

<ParamField body="specialty" type="array">
  Array com as especialidades, separadas 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 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" (período) ou "3" (desempenho).
</ParamField>

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

<ParamField body="volume" type="int">
  Número inteiro que representa o volume. Deve estar 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="content_action" type="int">
  0 = manter os cursos e conteúdos atuais e adicionar os novos (padrão);\
  1 = remover os cursos e conteúdos indicados e adicionar os novos;\
  2 = limpar todos os cursos e conteúdos indicados.
</ParamField>

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

<ParamField body="available_content_type" type="int">
  Tipo de conteúdo incluso em available\_content, separados por vírgula. Cada item deve ser "0" (tipo curso) ou "1" (tipo conteúdo), sendo cada dígito posicionalmente associado ao seu respectivo conteúdo em available\_content.\
  Exemplo: para os conteúdos Curso 01, Conteúdo 01, o tipo deve ser declarado como 0,1.
</ParamField>

<ParamField body="cover" type="string">
  URL da imagem de capa. Deve estar nos formatos 'jpeg', 'png' ou 'jpg' e ter no máximo 4096 KB. Caso não seja informada, será utilizada a logo da instituição.
</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">
  Campo para definir as turmas que serão vinculadas à trilha.\
  Caso o campo "trail\_is\_exclusive" seja verdadeiro (1) e "class\_ids" não seja informado, as turmas serão criadas automaticamente 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.