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

> O endpoint de edição de unidades permite alterar informações essenciais de instituições educacionais.

## Parâmetros

<ParamField path="schoolId" type="string" required>
  O identificador da unidade a ser editada.
</ParamField>

<ParamField body="name" type="string">
  O nome da unidade a ser editada. Deve ter no máximo 255 caracteres.
</ParamField>

<ParamField body="contractNumber" type="string">
  Número do contrato da unidade. Deve ser um valor único, com no máximo 50 caracteres.
</ParamField>

<ParamField body="tags" type="array">
  Deve ser um `array` de `strings` com no máximo 10 elementos, contendo as tags relacionadas à escola.
</ParamField>

<ParamField body="taxId" type="string">
  O CNPJ da unidade. Deve ser um CNPJ válido.
</ParamField>

<ParamField body="groups" type="number[]">
  Array contendo os identificadores dos grupos (Nível 1 de filtros) da instituição.
</ParamField>

<ParamField body="subgroups" type="number[]">
  Array contendo os identificadores dos subgrupos (Nível 2 de filtros) da instituição.
</ParamField>

<ParamField body="specialties" type="number[]">
  Array contendo os identificadores das especialidades (Nível 3 de filtros) da instituição.
</ParamField>

<ParamField body="colorScheme" type="object">
  Objeto contendo os valores das cores a serem utilizadas na unidade.
</ParamField>

<ParamField body="location" type="object">
  Objeto opcional contendo os dados de localização da unidade.
</ParamField>

<ParamField body="features" type="object">
  Objeto opcional contendo as configurações da unidade.
</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 o ID da unidade a ser editada.</Note>

## Descrição da Resposta

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

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

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

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

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

    <ResponseField name="urlSlug" type="string">
      Slug da URL da unidade.
    </ResponseField>

    <ResponseField name="contractNumber" type="string">
      Número do contrato associado à unidade.
    </ResponseField>

    <ResponseField name="tags" type="array">
      Lista de tags associadas à unidade.
    </ResponseField>

    <ResponseField name="taxId" type="string">
      Número de identificação fiscal (CNPJ).
    </ResponseField>

    <ResponseField name="groups" type="array">
      Lista de grupos associados à unidade.

      <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 à unidade.

      <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 à unidade.

      <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="colorScheme" type="object">
      Configuração do esquema de cores.

      <Expandable title="properties">
        <ResponseField name="primary" type="string">
          Código da cor primária.
        </ResponseField>

        <ResponseField name="secondary" type="string">
          Código da cor secundária.
        </ResponseField>

        <ResponseField name="buttonText" type="string">
          Código da cor do texto dos botões.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="social" type="object">
      Informações de redes sociais.

      <Expandable title="properties">
        <ResponseField name="facebook" type="string">
          Identificador do perfil do Facebook.
        </ResponseField>

        <ResponseField name="youtube" type="string">
          Identificador do canal do YouTube.
        </ResponseField>

        <ResponseField name="instagram" type="string">
          Identificador do perfil do Instagram.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="location" type="object">
      Detalhes de localização da unidade.

      <Expandable title="properties">
        <ResponseField name="street" type="string">
          Nome da rua.
        </ResponseField>

        <ResponseField name="number" type="string">
          Número da rua.
        </ResponseField>

        <ResponseField name="additionalDetails" type="string">
          Detalhes adicionais sobre a localização.
        </ResponseField>

        <ResponseField name="district" type="string">
          Nome do bairro.
        </ResponseField>

        <ResponseField name="city" type="string">
          Nome da cidade.
        </ResponseField>

        <ResponseField name="state" type="string">
          Abreviação do estado.
        </ResponseField>

        <ResponseField name="zipCode" type="string">
          Código postal (CEP).
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="features" type="object">
      Funcionalidades habilitadas para a unidade.

      <Expandable title="properties">
        <ResponseField name="enableTeacherRegistration" type="boolean">
          Indica se o cadastro de professores está habilitado.
        </ResponseField>

        <ResponseField name="enableStudentRegistration" type="boolean">
          Indica se o cadastro de alunos está habilitado.
        </ResponseField>

        <ResponseField name="enableGoogleLogin" type="boolean">
          Indica se o login via Google está habilitado.
        </ResponseField>

        <ResponseField name="enableLoginByDocument" type="boolean">
          Indica se o login por documento está habilitado.
        </ResponseField>

        <ResponseField name="enableLoginByEmail" type="boolean">
          Indica se o login por e-mail está habilitado.
        </ResponseField>

        <ResponseField name="enableForum" type="boolean">
          Indica se os fóruns estão habilitados.
        </ResponseField>

        <ResponseField name="enableViewCounter" type="boolean">
          Indica se o contador de visualizações está habilitado.
        </ResponseField>

        <ResponseField name="enableRating" type="boolean">
          Indica se a funcionalidade de avaliação está habilitada.
        </ResponseField>

        <ResponseField name="isPartOfProgram" type="boolean">
          Indica se a unidade faz parte de um programa.
        </ResponseField>

        <ResponseField name="enableReviews" type="boolean">
          Indica se as avaliações estão habilitadas.
        </ResponseField>

        <ResponseField name="showSchoolIconInMenu" type="boolean">
          Indica se o ícone da escola será exibido no menu.
        </ResponseField>

        <ResponseField name="showIconDetails" type="boolean">
          Indica se os detalhes do ícone serão exibidos.
        </ResponseField>

        <ResponseField name="replicateInstitutionMenuLinks" type="boolean">
          Indica se os links do menu da instituição serão replicados.
        </ResponseField>

        <ResponseField name="displaySchoolAccessButton" type="boolean">
          Indica se o botão de acesso à escola será exibido.
        </ResponseField>
      </Expandable>
    </ResponseField>

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

    <ResponseField name="updatedAt" type="string">
      Data e hora da última atualização da unidade.
    </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.