Skip to main content
POST
/
api
/
content
/
trail
/
edit_trail
/
{id_trilha}
Editar Trilhas
curl --request POST \
  --url https://kong.api.toolzz.com.br/api/content/trail/edit_trail/{id_trilha} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "trail_title": "<string>",
  "trail_description": "<string>",
  "clean_filters": "<string>",
  "group": [
    {}
  ],
  "subgroup": [
    {}
  ],
  "specialty": [
    {}
  ],
  "trail_start_date": "<string>",
  "trail_end_date": "<string>",
  "workload": 123,
  "certificate": "<string>",
  "progression_criteria": 123,
  "school": [
    {}
  ],
  "volume": 123,
  "tag": [
    {}
  ],
  "trail_view": 123,
  "content_action": 123,
  "available_content": "<string>",
  "available_content_type": 123,
  "cover": "<string>",
  "days_to_release": 123,
  "trail_is_exclusive": true,
  "class_ids": [
    {}
  ]
}'

​
Parâmetros

​
Id da trilha
string
required
Identificador da trilha que deseja editar
​
trail_title
string
required
Título da trilha. Deve ter no máximo 255 caracteres.
​
trail_description
string
required
Descrição da trilha.
​
clean_filters
string
0 ou null = manter os filtros registrados (padrão) — 1 = limpar filtros.
​
group
array
Array com os nomes dos grupos, separados por vírgula.
​
subgroup
array
Array com os nomes dos subgrupos, separados por vírgula.
​
specialty
array
Array com as especialidades, separadas por vírgula.
​
trail_start_date
date
Data de início da trilha. Deve ser igual ou posterior à data atual.
​
trail_end_date
date
Data de término da trilha. Deve ser posterior à trail_start_date.
​
workload
int
Carga horária. Deve ser maior que 0.
​
certificate
string
Certificado concedido na trilha. Deve ter no máximo 255 caracteres para o nome ou o ID do certificado.
​
progression_criteria
int
Critério de progressão. Deve ser “0” (sem critério), “1” (sequencial), “2” (período) ou “3” (desempenho).
​
school
array
required
Subdomínio das escolas onde a trilha será disponibilizada. Array com valores separados por vírgula.
​
volume
int
Número inteiro que representa o volume. Deve estar entre 1 e 10.
​
tag
array
Tags separadas por vírgula.
​
trail_view
int
Número que representa a visualização da trilha. Deve ser “0” para visual padrão ou “1” para visual gamificado.
​
content_action
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.
​
available_content
string
Conteúdos da trilha separados por vírgula. Cada item deve ser o nome ou o ID do conteúdo.
​
available_content_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.
​
cover
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.
​
days_to_release
int
Dias para liberar o próximo conteúdo. Obrigatório se progression_criteria for “2”. Deve ser maior que 1.
​
trail_is_exclusive
boolean
Campo para definir se a trilha é exclusiva.
​
class_ids
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

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