POSTLimpar registros antigos
Apaga os registros de atividade mais antigos que um número de dias, respeitando o mínimo de 7 dias.
O registro cresce sem parar. Esta rota apaga o que passou do prazo que você escolher, para controlar o tamanho do banco. A exclusão é definitiva e a própria limpeza fica registrada. Exige o privilégio manage_log_settings.
/api/v1/admin/logs/cleanupAdminApaga registros antigos
Corpo da requisição
older_than_daysintegerobrigatórioApaga o que tem mais de N dias. Obrigatório e maior que zero. Valores de 1 a 6 são tratados como 7.
Exemplo de requisição
Resposta
200Limpeza concluída
Campos da resposta
messagestringSempre
cleanup complete.deletedintegerQuantos registros foram apagados.
Erros
| Status | Quando | Exemplo de corpo |
|---|---|---|
| 401 | Token ausente, inválido ou expirado. | {"error":"missing authorization header"} |
| 403 | O token não é de um usuário administrador. | {"error":"admin access required"} |
| 403 | O usuário é administrador, mas não tem o privilégio exigido. | {"error":"insufficient privileges","privilege_required_any":["manage_log_settings"]} |
| 400 | Corpo inválido, ou older_than_days ausente, zero ou negativo. | {"error":"older_than_days must be a positive integer"} |
| 500 | Falha ao apagar. | {"error":"failed to cleanup logs","detail":"..."} |