BETA

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."
}
blockerQué pasaCómo seguís
dealtiene una operación viva?confirmed=deal
renttiene un alquiler activo?confirmed=rent
mlestá publicada en MercadoLibre desde Mapaprop?confirmed=ml
development_unitses un desarrollo con unidades vinculadasno 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ódigoCuándo
401Token ausente, vencido o inválido
404Ese paId no existe
409images_processing (procesando imágenes), published_on_portals (sigue publicada en algún portal) o blocked_in_mapaprop (algo vivo en tu cuenta)
502No 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