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

# Gerar Seções Embedáveis

> Este endpoint permite criar uma nova seção no catálogo, apresentando conteúdos em formato de cartão (card) em uma galeria carrossel.

## Parâmetros

<ParamField body="name" type="string" required>
  Nome da nova seção a ser criada.
</ParamField>

<ParamField body="description" type="string">
  Descrição da seção.
</ParamField>

<ParamField body="school" type="string">
  Identificador único da escola, permitindo a criação de seções exclusivas para cada unidade.
</ParamField>

<ParamField body="content_type" type="array" required>
  Array obrigatório que define os tipos de conteúdo a serem incluídos na seção.
</ParamField>

<ParamField body="groups" type="array">
  Array opcional contendo strings ou IDs dos grupos existentes. Os nomes ou IDs devem corresponder exatamente aos grupos já cadastrados.
</ParamField>

<ParamField body="subgroups" type="array">
  Array opcional contendo strings ou IDs dos subgrupos. Os nomes ou IDs devem corresponder exatamente aos subgrupos existentes e relacionados aos grupos.
</ParamField>

<ParamField body="specialties" type="array">
  Array opcional contendo strings ou IDs das especialidades. Os nomes ou IDs devem corresponder às especialidades existentes e relacionadas aos subgrupos.
</ParamField>

<ParamField body="order" type="array">
  Array contendo objetos com as propriedades criteria e orientation para definir a ordenação dos itens na seção.
</ParamField>

<ParamField body="criteria" type="int">
  alphabetical = 1 | creation\_date = 2 | price = 3 | random = 4
</ParamField>

<ParamField body="orientation" type="int">
  crescent = 1 | decrescent = 2
</ParamField>

<ParamField body="status" type="int" required>
  active = 1 | inactive = 2
</ParamField>

<ParamField body="content_attributes" type="int">
  **1 = Popularidade** (os mais acessados)\
  **2 = Avaliações** (os mais bem avaliados)\
  **3 = Novidades** (os criados mais recentemente)\
  **4 = Manual** (IDs específicos)
</ParamField>

<ParamField body="manual" type="array">
  Se content\_attributes for 4, deve ser incluído um array "manual" com os IDs dos itens desejados (máximo de 10 itens).
</ParamField>

<Note>Para utilizar este recurso, é necessário possuir a feature "Provas Classificatórias" ativa na plataforma.</Note>

<Note>Antes de utilizar este endpoint, certifique-se de possuir o seguinte parâmetro disponível:</Note>

## Detalhes dos parâmetros de requisição:

* `Token de acesso` `obrigatório`: Certifique-se de possuir um token de autenticação válido antes de prosseguir.
* `name` `obrigatório`: Nome da nova seção.
* `description`: Descrição da seção.
* `school`: Identificador da escola para criação de seções exclusivas da unidade.
* `content_type` `obrigatório`: **Array** indicando os tipos de conteúdos. Opções:
  * `courses` = 1
  * `components` = 2
  * `trail` = 3
  * `learning_object` = 4
  * `video` = 5
  * `audio` = 6
  * `album` = 7
  * `pdf` = 8
  * `text` = 9
  * `package` = 10
* `groups`: Array de strings ou IDs, representando os grupos associados.
* `subgroups`: Array de strings ou IDs, representando os subgrupos associados.
* `specialties`: Array de strings ou IDs, representando as especialidades associadas.
* `order`: Array de objetos para definir a ordenação dos itens na seção, com dois campos:
  * `criteria`: Inteiro para o critério de ordenação. Opções:
    * `alphabetical` = 1 (padrão)
    * `creation_date` = 2
    * `price` = 3
    * `random` = 4
  * `orientation`: Inteiro para a orientação da ordenação. Opções:
    * `crescent` = 1
    * `decrescent` = 2
* `status` `obrigatório`: Inteiro para definir o status da seção. Opções:
  * `active` = 1
  * `inactive` = 2
* `content_attributes`: Inteiro para definir o critério de seleção de itens para a seção:
  * `1`: Popularidade (os mais acessados)
  * `2`: Avaliações (os mais bem avaliados)
  * `3`: Novidades (os mais recentes)
  * `4`: Manual (IDs específicos)
    * Se `content_attributes` for `4`, incluir o objeto `manual` com um array de IDs (máximo de 10 itens).