DELETE /properties/{paId}
Borrar acá borra la propiedad en la cuenta de Mapaprop. Es el mismo borrado que hace el botón Eliminar de la webapp: se va la ficha y todo lo suyo. No es reversible.
Pero NO da de baja tus avisos en los portales. Los avisos son tuyos, publicados con tu cuenta de
cada portal, y no los tocamos. Para bajarlos tenés
DELETE /publication/{portal} — y si intentás borrar una
propiedad que sigue publicada, te avisamos antes con un 409 que nombra los portales.
Resource URL
DELETE https://property-api.mapaprop.com/property-v1/properties/{paId}
El paId es el que te devolvió el alta. Si no lo tenés,
listá tus propiedades.
Autenticación
Authorization: Bearer <tu token>.
curl -X DELETE https://property-api.mapaprop.com/property-v1/properties/01M3PTZ8YBMM5DSNW03WP8VD9E \
-H "Authorization: Bearer $TOKEN"
La respuesta
La respuesta trae el clientRef, el mismo que mandaste en el sobre. Te lo devolvemos en los seis
caminos (verify, alta, consulta, listado, edición y borrado) para que puedas cruzarlo con tu base sin
tener que recordar con qué clientRef preguntaste.
{
"paId": "01M3PTZ8YBMM5DSNW03WP8VD9E",
"status": "deleted",
"deletedAt": "2026-09-29T15:20:11.482Z"
}
La propiedad queda en status: "deleted". Deja de aparecer en el listado, y consultarla te la devuelve
con ese estado.
Si sigue publicada, te lo decimos antes
Borrar una propiedad que todavía tiene avisos vivos te deja con el estado partido: borrada acá, publicada allá. Así que el primer intento rebota y nombra los portales:
{
"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."
}
Tenés dos caminos, y los dos son válidos:
1 · Despublicar primero (lo normal): DELETE /publication/{portal}
para cada portal de la lista, y después el borrado.
2 · Forzar, si lo que querés es sacarla de tu inventario y dejar los avisos como están:
curl -X DELETE "https://property-api.mapaprop.com/property-v1/properties/01M3PTZ8YBMM5DSNW03WP8VD9E?force=true" \
-H "Authorization: Bearer $TOKEN"
La respuesta te dice qué quedó publicado, para que puedas anotarlo:
{
"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."
}
Forzar no te deja sin salida: el borrado es reversible del lado del estado, así que podés
despublicar después usando el mismo paId. Lo que no hacemos nunca es dar de baja un aviso tuyo sin
que lo pidas.
?force=true tiene que ser exactamente eso. Un force=1 o force=false no fuerza: ante la duda
preferimos pedirte la confirmación antes que dejarte avisos vivos sin que lo hayas decidido.
Y un portal que quedó con error, o que ya habías despublicado, no cuenta: sólo bloquean los avisos que están realmente arriba.
Si la propiedad tiene algo vivo en Mapaprop, también te avisamos
Mapaprop no deja borrar una propiedad que tiene una operación viva, un alquiler activo o está publicada
en MercadoLibre. Son las mismas tres condiciones que la webapp te pide confirmar antes de borrar, y acá
llegan como un 409 que las nombra:
{
"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 | Qué pasa | Cómo seguís |
|---|---|---|
deal | tiene una operación viva | ?confirmed=deal |
rent | tiene un alquiler activo | ?confirmed=rent |
ml | está publicada en MercadoLibre desde Mapaprop | ?confirmed=ml |
development_units | es un desarrollo con unidades vinculadas | no se confirma — desvinculalas primero |
Para confirmar varios a la vez, separalos con coma: ?confirmed=deal,rent,ml.
Confirmar no deshace nada: borra igual, con la operación o el alquiler adentro. Confirmá sólo si sabés lo que se va.
El desarrollo con unidades es distinto
Ese no se puede confirmar, porque no hay nada que aceptar: primero hay que desvincular las unidades. Se
hace con un PUT que mande development.units vacío, y después
el borrado entra normal:
PUT /property-v1/properties/{paId} → canonical.development.units: []
DELETE /property-v1/properties/{paId} → 200
Las unidades no se borran: quedan como propiedades sueltas en tu inventario.
Es idempotente
Borrar algo ya borrado responde 200 igual, con yaEstabaBorrada: true:
{ "paId": "01M3PTZ8YBMM5DSNW03WP8VD9E", "status": "deleted", "yaEstabaBorrada": true }
Podés reintentar sin miedo a duplicar nada.
Errores
| Código | Cuándo |
|---|---|
401 | Token ausente, vencido o inválido |
404 | Ese paId no existe |
409 | images_processing (procesando imágenes), published_on_portals (sigue publicada en algún portal) o blocked_in_mapaprop (algo vivo en tu cuenta) |
502 | No pudimos borrarla en Mapaprop, así que tampoco la borramos acá — reintentá |
Los tres 409
Se distinguen por el error, que es un código: published_on_portals (avisos vivos en portales),
blocked_in_mapaprop (algo vivo en tu cuenta) e images_processing — si el alta todavía las está
descargando, no se puede borrar:
{
"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}."
}
Consultá el GET y reintentá cuando images.status deje de ser
processing.
Y un 502 que es una garantía, no una falla
Si no pudimos borrar la propiedad en Mapaprop, tampoco la borramos acá:
{ "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." }
Reintentar es seguro: si para entonces ya no estaba, el borrado se completa igual.
Relacionados
- POST /properties — el alta
- GET /properties — consultar y listar
- DELETE /publication/{portal} — dar de baja el aviso, que es otra cosa