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âmetro | Tipo | Descrição |
|---|---|---|
id | UUID | ID do filtro de eventos. |
Comportamento
O endpoint valida nesta ordem, e a primeira verificação que falhar aborta a operação:
- Existência — se não houver um filtro de eventos com esse
idno tenant, responde404(Event criteria not found). - Arquivado — o filtro é arquivado junto com seus blocos de consulta, e o endpoint
responde
204 No Contentsem 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
| Status | Descrição |
|---|---|
400 | O id não é um UUID válido. |
401 | Ausente ou inválido o Authorization: Bearer. |
403 | O usuário não tem a permissão event-criteria:delete, ou o x-tenant-id não está autorizado. |
404 | Não existe um filtro de eventos com esse id no tenant (Event criteria not found). |