Skip to main content
POST
Criar Unidades

Parâmetros

string
required
O nome da unidade a ser criada. Deve conter no máximo 255 caracteres.
string
required
URL da unidade. Deve ser um valor único, em um formato de URL válido, com no máximo 255 caracteres.
number[]
required
Array contendo os identificadores de grupos (Nível 1 de filtros) da instituição.
number[]
Array contendo os identificadores de subgrupos (Nível 2 de filtros) da instituição.
number[]
Array contendo os identificadores de especialidades (Nível 3 de filtros) da instituição.
object
required
Objeto contendo os valores das cores a serem utilizadas na unidade.
string
required
Cor primária da identidade visual da unidade, geralmente utilizada como cor de destaque.
string
required
Cor secundária complementar da identidade visual da unidade.
string
required
Cor do texto exibido em botões da interface.
object
required
Objeto opcional contendo os dados de localização da unidade.
string
required
Nome da rua onde a unidade está localizada.
string
required
Número do endereço da unidade.
string
required
Bairro onde a unidade está localizada.
string
required
Cidade onde a unidade está localizada.
string
required
Estado (UF) onde a unidade está localizada.
string
required
Código postal (CEP) do endereço da unidade.
object
[Inconsistência] Objeto contendo as configurações da unidade em formato boolean.
boolean
Ativa ou desativa a opção de cadastro de professores na unidade.
boolean
Ativa ou desativa a opção de cadastro de alunos na unidade.
boolean
Ativa ou desativa o login por conta Google.
boolean
Ativa ou desativa o login utilizando número de documento.
boolean
Ativa ou desativa o login por e-mail.
boolean
Indica se a unidade pertence a um programa institucional específico.
boolean
Ativa ou desativa a funcionalidade de fórum na unidade.
boolean
Ativa ou desativa a contagem de visualizações de conteúdos.
boolean
Ativa ou desativa a funcionalidade de avaliação (nota) de conteúdos.
boolean
Ativa ou desativa a possibilidade de comentários ou resenhas.
boolean
Exibe ou oculta o ícone da escola no menu de navegação.
boolean
Exibe ou oculta detalhes visuais dos ícones associados à escola.
Ativa ou desativa a replicação dos links do menu institucional.
boolean
Exibe ou oculta o botão de acesso direto à unidade escolar.
string
Número do contrato. Deve ser um valor único, com no máximo 50 caracteres.
array
Deve ser um array de strings, com no máximo 10 elementos.
string
O CNPJ da unidade. Deve ser um CNPJ válido.
Antes de utilizar este endpoint, certifique-se de possuir os seguintes parâmetros disponíveis:
  • Nome da unidade obrigatório: Defina um nome para a sua unidade.
  • Slug da URL obrigatório: Necessário caso a busca seja realizada pelo slug.
  • Grupos obrigatório: ID do(s) grupo(s) da instituição a serem vinculados a essa unidade.
  • Esquema de cores da unidade obrigatório: Defina os valores em hexadecimal para as cores primária, secundária e da fonte dos botões.
  • Configurações da unidade obrigatório: Defina quais são os parâmetros essenciais para a sua unidade de aprendizado.

Descrição da Resposta

Abaixo está um exemplo da resposta retornada por este endpoint.
boolean
Indica se a solicitação foi bem-sucedida.
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.
object
Detalhes da unidade educacional.

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 conta com outras medidas de segurança para proteger os dados dos usuários.