---
title: "Inclui, altera ou remove portais (anúncios) em imóveis do Imoview CRM"
method: POST
path: "/Imovel/AlterarPortaisImoveis"
tags: ["Imóveis"]
---

# Inclui, altera ou remove portais (anúncios) em imóveis do Imoview CRM

`POST /Imovel/AlterarPortaisImoveis`

## Request

- Base URL: `https://api.imoview.com.br`
- URL: `https://api.imoview.com.br/Imovel/AlterarPortaisImoveis`
- Auth: API key in header `chave`

Retorno JSON para incluir/alterar (ou remover) o anúncio de imóveis em portais do imoview CRM. Aceita lote nos dois níveis - vários imóveis e vários portais por imóvel - sendo um imóvel com um portal o caso particular.<br><br><strong>codigoportal = 0</strong> significa 'meu site' (marca/desmarca 'Exibir meu site' e o destaque do site).<br><strong>tipodestaque</strong> não informado mantém o destaque atual do anúncio (assume 1 - simples quando o imóvel ainda não está no portal).<br>Chave inválida e erros de entrada (lista de imóveis vazia ou acima do máximo, usuário inexistente ou sem a autoridade) retornam 401/404 como nos demais endpoints. Passada essa etapa, um erro em um item <strong>não interrompe o lote</strong>: o retorno é sempre 200 com o resultado de cada imóvel/portal em <strong>lista</strong> (sucesso e mensagem). O portal precisa estar habilitado para o convênio na inclusão/alteração (na remoção não).<br><br>Tokens disponíveis:<br>codigousuario: OPCIONAL - Enviar o usuário do Imoview CRM, que precisa ter a autoridade 'Gerenciar imóveis em portais'. Não enviando, a alteração é auditada no usuário robô<br>imoveis [{ OBRIGATÓRIO - Enviar ao menos um imóvel, máximo 100<br>codigoimovel: OBRIGATÓRIO - Enviar o código do imóvel<br>portais [{ OBRIGATÓRIO - Enviar ao menos um portal (o mesmo portal não pode ser repetido para o mesmo imóvel)<br>codigoportal: OBRIGATÓRIO - Enviar o código do portal habilitado no convênio ou 0 para meu site<br>tipodestaque: OPCIONAL - Enviar 1 (simples), 2 (destaque), 3 (super destaque), 4 (premiere destaque especial), 5 (premiere destaque premium) ou 6 (triplo). Não enviando, mantém o destaque atual do anúncio<br>remover: OPCIONAL - Enviar true para retirar o imóvel do portal, caso contrário assumirá false (inclui/altera)<br>}]<br>}]

## Request body

- object
  - `codigousuario` integer
  - `imoveis` object[]
    - `codigoimovel` integer
    - `portais` object[]
      - `codigoportal` integer
      - `tipodestaque` integer
      - `remover` boolean

## Response `200`

Retornado com sucesso

- object
  - `quantidadesucesso` integer
  - `quantidadeerro` integer
  - `lista` object[]
    - `codigoimovel` integer
    - `codigoportal` integer
    - `nomeportal` string, string
    - `sucesso` boolean
    - `mensagem` string, string

## Other responses

- `401`: Header 'chave' ausente ou inválido, ou chave/usuário sem permissão para a operação
- `403`: Regra de negócio violada ou limite de paginação excedido
- `404`: Parâmetro obrigatório ausente ou inválido, registro não encontrado ou consulta sem resultado
- `429`: Limite de requisições da chave excedido
- `500`: Falha interna não prevista

## Changes

- **2026-10-09** `d7f65bff1506`: 8 breaking, 5 info
  - the `codigousuario` request property format changed from `Int64` to `int64`
  - the `imoveis/items/codigoimovel` request property format changed from `Int64` to `int64`
  - the `imoveis/items/portais/items/codigoportal` request property format changed from `Int64` to `int64`
  - the `imoveis/items/portais/items/tipodestaque` request property format changed from `Int64` to `int64`
  - …9 more

[Operation history](https://skmtc.dev/imoview/apis/imoview-api/changes/Imovel/AlterarPortaisImoveis/post.md)

---

[API](https://skmtc.dev/imoview/apis/imoview-api.md) - [All operations](https://skmtc.dev/imoview/apis/imoview-api/llms.txt) - [OpenAPI document](https://skmtc.dev/imoview/apis/imoview-api/revisions/436e609983d0?raw)