Skip to main content
POST
Permanently Delete Leads in Bulk
Notas de seguridad y comportamiento
  • Antes de cada eliminación se escribe una copia forense en lead_hard_delete_audit dentro de la misma transacción.
  • La cancelación de trabajos activos de cadencia se intenta después de confirmar la eliminación; si falla, los datos no se restauran.
  • Cada lead se confirma de forma independiente, sin una transacción ni reversión para el lote completo.
  • Esta operación es irreversible y elimina de forma permanente cada lead coincidente junto con conversaciones, mensajes, reuniones, llamadas, valores de campos, notas y tareas en cascada.
  • La vista previa de MCP no llama a esta operación REST y no forma parte del contrato REST.
  • REST directo exige confirm=true. Omitir confirm o enviar false devuelve HTTP 400 y no ofrece una vista previa.

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Cuerpo

application/json
lead_ids
any[]
requerido
Required array length: 1 - 500 elements

String UUIDs are processed; malformed/non-string entries are returned in failed[]. Duplicates are silently de-duplicated after total is captured.

confirm
enum<boolean>
requerido
Opciones disponibles:
true

Respuesta

Permanent-delete batch outcome; partial/per-row failures remain HTTP 200.

success
boolean
requerido
total
integer
requerido
Rango requerido: 1 <= x <= 500
hard_deleted
integer
requerido
Rango requerido: x >= 0
failed
object[]
requerido
Última modificación el 8 de septiembre de 2026