Mapaprop
BETA

DELETE /properties/{paId}

Excluir aqui NÃO dá baixa nos seus anúncios nos portais. Os anúncios são seus, publicados com a sua conta em cada portal. Se quiser tirá-los do ar, isso se faz em cada portal.

Resource URL

DELETE https://property-api.mapaprop.com/property-v1/properties/{paId}

O paId é o que o cadastro devolveu. Se você não o tiver, liste seus imóveis.

Autenticação

Authorization: Bearer <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. Nós o devolvemos nos seis caminhos (verify, cadastro, consulta, listagem, edição e exclusão) para que você possa cruzá-lo com a sua base sem ter que 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 lista, e consultá-lo o devolve com esse estado.

É idempotente

Excluir algo já excluído responde 200 do mesmo jeito, com yaEstabaBorrada: true:

{ "paId": "01M3PTZ8YBMM5DSNW03WP8VD9E", "status": "deleted", "yaEstabaBorrada": true }

Você pode tentar de novo sem risco de duplicar nada.

Erros

CódigoQuando
401Token ausente, vencido ou inválido
404Esse paId não existe
409O imóvel está processando suas imagens

O 409

Se o cadastro ainda estiver baixando as imagens, não é possível excluir:

{
  "status": 409,
  "error": "La propiedad está procesando sus imágenes",
  "detail": "Procesando 2 de 4 imágenes. No se puede modificar ni publicar hasta que terminen."
}

Consulte o GET e tente de novo quando images.status deixar de ser processing.

Relacionados