Reten Docs
Filtros de eventos

Eliminar filtro de eventos

Archiva (soft delete) un filtro de eventos; responde 204 sin cuerpo.

DELETE /api/event-criterias/:id

Archiva un filtro de eventos. Al eliminarlo, el registro se retira de inmediato de la tabla del recurso —por eso deja de aparecer en GET /event-criterias/:id (responde 404) y en GET /event-criterias— y en su lugar se conserva un snapshot recuperable en la papelera durante una ventana de retención configurable.

Auth: Requerida — permiso event-criteria:delete

Parámetros de ruta

ParámetroTipoDescripción
idUUIDID del filtro de eventos.

Comportamiento

El endpoint valida en este orden, y el primer control que falla corta la operación:

  1. Existencia — si no hay un filtro de eventos con ese id en el tenant, responde 404 (Event criteria not found).
  2. Archivado — el filtro se archiva junto con sus bloques de consulta, y el endpoint responde 204 No Content sin cuerpo.

A diferencia de las audiencias, no hay un control de "no referenciado": un filtro de eventos no se compone con otros filtros, así que nunca es operando de nadie y su eliminación no puede quedar bloqueada por otro recurso.

Ejemplo

curl -X DELETE https://api.reten.ai/api/event-criterias/9f3a1c22-4b7e-4c31-9a8d-2f5e6b7c8d90 \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>" \
  -H "x-project-id: <project-id>"
# → HTTP/1.1 204 No Content (cuerpo vacío)
import axios from 'axios';

const id = '9f3a1c22-4b7e-4c31-9a8d-2f5e6b7c8d90';
await axios.delete(
  `https://api.reten.ai/api/event-criterias/${id}`,
  { headers: { Authorization: 'Bearer <token>', 'x-tenant-id': '<tenant-id>', 'x-project-id': '<project-id>' } },
);
// La respuesta es 204 sin cuerpo; axios no rechaza (2xx).

Respuesta 204 No Content

Cuerpo vacío. El filtro quedó archivado.

Respuestas de error

EstadoDescripción
400El id no es un UUID válido.
401Falta o es inválido el Authorization: Bearer.
403El usuario no tiene el permiso event-criteria:delete, o el x-tenant-id no está autorizado.
404No existe un filtro de eventos con ese id en el tenant (Event criteria not found).