DELETE /api/alertas/:id
Remove permanentemente um alerta. Após a exclusão, nenhuma notificação será mais enviada por este alerta.
Autenticação
Scope necessário: alerts:write
Inclua o header Authorization: Bearer <api-key> ou use cookie de sessão.
Requisição
DELETE /api/alertas/:id
Headers
| Header | Obrigatório | Descrição |
|---|---|---|
Authorization | sim | Bearer pk_... (API key) ou cookie de sessão |
Parâmetros de rota
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | sim | UUID do alerta |
Exemplo
curl -X DELETE "https://api.placaflow.com.br/api/alertas/a1b2c3d4-5678-9abc-def0-123456789abc" \
-H "Authorization: Bearer pk_a1b2c3d4e5f6g7h8i9j0..."
Resposta 200
{
"success": true
}
Atenção
A exclusão é irreversível. Todas as configurações do alerta, incluindo histórico de disparos, serão removidas permanentemente.
Erros
| Código | Descrição |
|---|---|
| 401 | Não autenticado ou API key inválida |
| 403 | API key não possui scope alerts:write |
| 404 | Alerta não encontrado |