BETA

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."
}
blockerO que aconteceComo prosseguir
dealtem uma operação ativa?confirmed=deal
renttem uma locação ativa?confirmed=rent
mlestá publicado no MercadoLibre a partir do Mapaprop?confirmed=ml
development_unitsé um empreendimento com unidades vinculadasnã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ódigoQuando
401Token ausente, vencido ou inválido
404Esse paId não existe
409images_processing (processando imagens), published_on_portals (continua publicado em algum portal) ou blocked_in_mapaprop (algo ativo na sua conta)
502Nã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