API atual/Referência completa/Registro de atividades

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.

POST/api/v1/admin/logs/cleanupAdmin

Apaga registros antigos

Corpo da requisição

older_than_daysintegerobrigatório

Apaga 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

bash

curl -X POST "$BASE_URL/api/v1/admin/logs/cleanup" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"older_than_days": 90}'

Resposta

200Limpeza concluída

json

{
  "message": "cleanup complete",
  "deleted": 1520
}

Campos da resposta

messagestring

Sempre cleanup complete.

deletedinteger

Quantos 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":"..."}`

Veja também

Consultar registros