DELETE /properties/{paId}
Excluir aqui exclui o imóvel na conta do Mapaprop. É a mesma exclusão que o botão Excluir do webapp faz: a ficha e tudo o que está ligado a ela vão embora. Não é reversível.
Mas NÃO retira os seus anúncios dos portais. Os anúncios são seus, publicados com a sua conta em
cada portal, e não mexemos neles. Para retirá-los você tem
DELETE /publication/{portal} — e se tentar excluir um
imóvel que continua publicado, avisamos antes com um 409 que nomeia os portais.
Resource URL
DELETE https://property-api.mapaprop.com/property-v1/properties/{paId}
O paId é o que a criação devolveu. Se você não o tiver,
liste os seus imóveis.
Autenticação
Authorization: Bearer <o seu token>.
curl -X DELETE https://property-api.mapaprop.com/property-v1/properties/01M3PTZ8YBMM5DSNW03WP8VD9E \
-H "Authorization: Bearer $TOKEN"
A resposta
A resposta traz o clientRef, o mesmo que você enviou no envelope. Devolvemos nos seis caminhos
(verify, criação, consulta, listagem, edição e exclusão) para que você possa cruzá-lo com a sua base sem
ter de lembrar com qual clientRef perguntou.
{
"paId": "01M3PTZ8YBMM5DSNW03WP8VD9E",
"status": "deleted",
"deletedAt": "2026-09-29T15:20:11.482Z"
}
O imóvel fica em status: "deleted". Deixa de aparecer na listagem, e consultá-lo devolve-o com esse
estado.
Se continuar publicado, avisamos antes
Excluir um imóvel que ainda tem anúncios ativos deixa você com o estado partido: excluído aqui, publicado lá. Por isso a primeira tentativa recusa e nomeia os portais:
{
"error": "published_on_portals",
"portals": ["zonapropapi"],
"detail": "Esa propiedad sigue publicada en zonapropapi. Despublicala primero con DELETE /property-v1/properties/{paId}/publication/{portal}, o repetí este borrado con ?force=true si querés borrarla acá y dejar los avisos como están."
}
Você tem dois caminhos, e os dois são válidos:
1 · Despublicar primeiro (o habitual): DELETE /publication/{portal}
para cada portal da lista, e depois a exclusão.
2 · Forçar, se o que você quer é tirá-lo do seu inventário e deixar os anúncios como estão:
curl -X DELETE "https://property-api.mapaprop.com/property-v1/properties/01M3PTZ8YBMM5DSNW03WP8VD9E?force=true" \
-H "Authorization: Bearer $TOKEN"
A resposta informa o que ficou publicado, para que você possa anotar:
{
"paId": "01M3PTZ8YBMM5DSNW03WP8VD9E",
"status": "deleted",
"forced": true,
"portalsStillPublished": ["zonapropapi"],
"detail": "Se borró de Mapaprop. Los avisos de zonapropapi siguen publicados: no los dimos de baja. Podés despublicarlos con DELETE /property-v1/properties/{paId}/publication/{portal} usando este mismo paId."
}
Forçar não deixa você sem saída: a exclusão é reversível do lado do estado, portanto você pode
despublicar depois usando o mesmo paId. O que nunca fazemos é retirar um anúncio seu sem que você
peça.
?force=true tem de ser exatamente isso. Um force=1 ou force=false não força: na dúvida
preferimos pedir a sua confirmação a deixar anúncios ativos sem que você tenha decidido.
E um portal que ficou com erro, ou que você já havia despublicado, não conta: só bloqueiam os anúncios que estão realmente no ar.
Se o imóvel tiver algo ativo no Mapaprop, também avisamos antes
O Mapaprop não permite excluir um imóvel que tenha uma operação ativa, uma locação ativa ou que esteja
publicado no MercadoLibre. São as mesmas três condições que o webapp pede para confirmar antes de
excluir, e aqui chegam como um 409 que as nomeia:
{
"status": 409,
"error": "blocked_in_mapaprop",
"blockers": ["deal"],
"precheck": { "hasDeal": true, "activeDealCount": 1, "activeDealStates": ["reservada"] },
"detail": "Tiene una operación viva en Mapaprop. Si aún así querés borrarla, repetí el pedido con `?confirmed=deal` — es la misma confirmación que te pide la webapp antes de borrar."
}
blocker | O que acontece | Como prosseguir |
|---|---|---|
deal | tem uma operação ativa | ?confirmed=deal |
rent | tem uma locação ativa | ?confirmed=rent |
ml | está publicado no MercadoLibre a partir do Mapaprop | ?confirmed=ml |
development_units | é um empreendimento com unidades vinculadas | não se confirma — desvincule-as primeiro |
Para confirmar vários de uma vez, separe-os por vírgula: ?confirmed=deal,rent,ml.
Confirmar não desfaz nada: exclui do mesmo jeito, com a operação ou a locação dentro. Confirme apenas se souber o que está indo embora.
O empreendimento com unidades é diferente
Esse não pode ser confirmado, porque não há nada a aceitar: primeiro é preciso desvincular as unidades.
Faz-se com um PUT enviando development.units vazio, e depois a
exclusão entra normalmente:
PUT /property-v1/properties/{paId} → canonical.development.units: []
DELETE /property-v1/properties/{paId} → 200
As unidades não são excluídas: permanecem como imóveis avulsos no seu inventário.
É idempotente
Excluir algo já excluído responde 200 do mesmo jeito, com yaEstabaBorrada: true:
{ "paId": "01M3PTZ8YBMM5DSNW03WP8VD9E", "status": "deleted", "yaEstabaBorrada": true }
Você pode repetir sem medo de duplicar nada.
Erros
| Código | Quando |
|---|---|
401 | Token ausente, vencido ou inválido |
404 | Esse paId não existe |
409 | images_processing (processando imagens), published_on_portals (continua publicado em algum portal) ou blocked_in_mapaprop (algo ativo na sua conta) |
502 | Não conseguimos excluí-lo no Mapaprop, por isso também não o excluímos aqui — repita |
Os três 409
Distinguem-se pelo error, que é um código: published_on_portals (anúncios ativos em portais),
blocked_in_mapaprop (algo ativo na sua conta) e o das imagens — se a criação ainda estiver baixando-as,
não é possível excluir:
{
"status": 409,
"error": "images_processing",
"detail": "La propiedad está procesando sus imágenes. Procesando 2 de 4 imágenes. No se puede modificar ni publicar hasta que terminen. El estado está en GET /property-v1/properties/{paId}."
}
Consulte o GET e repita quando images.status deixar de ser
processing.
E um 502 que é uma garantia, não uma falha
Se não conseguimos excluir o imóvel no Mapaprop, também não o excluímos aqui:
{ "status": 502, "error": "mapaprop_delete_failed",
"detail": "No pudimos borrar la propiedad en Mapaprop, así que tampoco la borramos acá: dejarte una mitad borrada sería peor. Reintentá en unos minutos; si sigue, escribinos." }
Repetir é seguro: se a essa altura ele já não estiver lá, a exclusão se completa do mesmo jeito.
Relacionados
- POST /properties — a criação
- GET /properties — consultar e listar
- DELETE /publication/{portal} — retirar o anúncio, que é outra coisa