POST
/
api
/
content
/
trail
/
edit_trail
/
{id_trilha}
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

Identificador da trilha que deseja editar

​
trail_title
string

Título da trilha. Deve ter no máximo 255 caracteres.

​
trail_description
string

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

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.