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ámetro | Tipo | Descripción |
|---|---|---|
id | UUID | ID del filtro de eventos. |
Comportamiento
El endpoint valida en este orden, y el primer control que falla corta la operación:
- Existencia — si no hay un filtro de eventos con ese
iden el tenant, responde404(Event criteria not found). - Archivado — el filtro se archiva junto con sus bloques de consulta, y el endpoint
responde
204 No Contentsin 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
| Estado | Descripción |
|---|---|
400 | El id no es un UUID válido. |
401 | Falta o es inválido el Authorization: Bearer. |
403 | El usuario no tiene el permiso event-criteria:delete, o el x-tenant-id no está autorizado. |
404 | No existe un filtro de eventos con ese id en el tenant (Event criteria not found). |