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

> Com este endpoint, é possível alterar o código e o título da turma, além de associá-la a grupos, subgrupos e especialidades.

## Parâmetros

<ParamField path="schoolId" type="string" required>
  O identificador da escola à qual a turma a ser editada está associada.
</ParamField>

<ParamField path="classroomId" type="string">
  O identificador da turma a ser editada.
</ParamField>

<ParamField body="title" type="string">
  Título da turma.
</ParamField>

<ParamField body="code" type="string">
  Código da turma.
</ParamField>

<ParamField body="type" type="enum">
  Tipo da turma a ser editada. A turma do tipo filtro é a turma padrão da plataforma, relacionando-se com os conteúdos exclusivos que possuem os mesmos filtros.
  FILTER
  ou
  EXCLUSIVE\_CONTENT
</ParamField>

<ParamField body="group" type="array">
  ID de um ou mais grupos da instituição a serem vinculados à turma.
</ParamField>

<ParamField body="subgroups" type="array">
  ID de um ou mais subgrupos da instituição a serem vinculados à turma.
</ParamField>

<ParamField body="specialties" type="array">
  ID de uma ou mais especialidades da instituição a serem vinculadas à turma.
</ParamField>

<ParamField body="contents" type="array">
  Conteúdos associados ao item.
</ParamField>

<Warning>Este endpoint funcionará corretamente apenas se o domínio da sua instituição for informado manualmente na URL, caso contrário, o endpoint poderá falhar ou retornar um erro de validação.</Warning>

<Note>Antes de utilizar este endpoint, certifique-se de possuir os seguintes parâmetros disponíveis:</Note>

<Info>O ID da unidade é necessário para identificar a unidade à qual a turma será editada.</Info>

<Info>O ID dos filtros é necessário para identificar os filtros (grupo, subgrupo e especialidade) a serem vinculados à turma.</Info>

## Descrição da Resposta

Abaixo está um exemplo da resposta retornada por este endpoint.

<ResponseField name="success" type="boolean">
  Indica se a requisição foi bem-sucedida.
</ResponseField>

<ResponseField name="data" type="object">
  Detalhes da turma.

  <Expandable title="properties">
    <ResponseField name="id" type="number">
      Identificador único da turma.
    </ResponseField>

    <ResponseField name="schoolId" type="string">
      Identificador da escola associada.
    </ResponseField>

    <ResponseField name="title" type="string">
      Título da turma.
    </ResponseField>

    <ResponseField name="code" type="string">
      Código da turma.
    </ResponseField>

    <ResponseField name="image" type="string">
      URL da imagem da turma (pode ser nulo).
    </ResponseField>

    <ResponseField name="course" type="string">
      Nome do curso associado (pode ser nulo).
    </ResponseField>

    <ResponseField name="group" type="array">
      Lista de grupos associados à turma.

      <Expandable title="items">
        <ResponseField name="id" type="number">
          Identificador único do grupo.
        </ResponseField>

        <ResponseField name="name" type="string">
          Nome do grupo.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="subgroups" type="array">
      Lista de subgrupos associados à turma.

      <Expandable title="items">
        <ResponseField name="id" type="number">
          Identificador único do subgrupo.
        </ResponseField>

        <ResponseField name="name" type="string">
          Nome do subgrupo.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="specialties" type="array">
      Lista de especialidades associadas à turma.

      <Expandable title="items">
        <ResponseField name="id" type="number">
          Identificador único da especialidade.
        </ResponseField>

        <ResponseField name="name" type="string">
          Nome da especialidade.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="trails" type="array">
      Lista de trilhas associadas à turma.
    </ResponseField>

    <ResponseField name="contents" type="array">
      Lista de conteúdos associados à turma.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Data e hora de criação da turma.
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      Data e hora da última atualização da turma.
    </ResponseField>
  </Expandable>
</ResponseField>

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