Reten Docs
Filtros de eventos

Excluir filtro de eventos

Arquiva (soft delete) um filtro de eventos; responde 204 sem corpo.

DELETE /api/event-criterias/:id

Arquiva um filtro de eventos. Ao excluí-lo, o registro é removido imediatamente da tabela do recurso —por isso deixa de aparecer em GET /event-criterias/:id (responde 404) e em GET /event-criterias— e em seu lugar é mantido um snapshot recuperável na lixeira durante uma janela de retenção configurável.

Auth: Obrigatória — permissão event-criteria:delete

Parâmetros de rota

ParâmetroTipoDescrição
idUUIDID do filtro de eventos.

Comportamento

O endpoint valida nesta ordem, e a primeira verificação que falhar aborta a operação:

  1. Existência — se não houver um filtro de eventos com esse id no tenant, responde 404 (Event criteria not found).
  2. Arquivado — o filtro é arquivado junto com seus blocos de consulta, e o endpoint responde 204 No Content sem corpo.

Diferente das audiências, não há uma verificação de "não referenciado": um filtro de eventos não se compõe com outros filtros, então nunca é operando de ninguém e sua exclusão não pode ser bloqueada por outro recurso.

Exemplo

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 (corpo vazio)
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>' } },
);
// A resposta é 204 sem corpo; o axios não rejeita (2xx).

Resposta 204 No Content

Corpo vazio. O filtro foi arquivado.

Respostas de erro

StatusDescrição
400O id não é um UUID válido.
401Ausente ou inválido o Authorization: Bearer.
403O usuário não tem a permissão event-criteria:delete, ou o x-tenant-id não está autorizado.
404Não existe um filtro de eventos com esse id no tenant (Event criteria not found).