Skip to content

API — Audit log

Journal d'activité traçant les actions sensibles de chaque utilisateur.


Lister les logs

GET /api/audit 🔒

Retourne les logs d'audit de l'utilisateur authentifié, paginés et triés par date décroissante.

Query params

ParamDéfautDescription
page1Numéro de page
limit20Nombre de résultats par page
action(tous)Filtrer par type d'action

Réponse 200

json
{
  "data": [
    {
      "id": "uuid",
      "user_id": "uuid",
      "action": "user.login",
      "target_type": null,
      "target_id": null,
      "details": { "ipAddress": "192.168.1.1" },
      "ip_address": "192.168.1.1",
      "created_at": "2026-03-30T10:00:00Z"
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 20
}

Actions tracées

ActionDéclencheur
user.registerInscription d'un utilisateur
user.loginConnexion par mot de passe
user.login_ssoConnexion via Google SSO
user.2fa_enableActivation de la 2FA
user.2fa_disableDésactivation de la 2FA
rule.createCréation d'une règle
rule.create_from_templateCréation d'une règle depuis un template
rule.updateModification d'une règle
rule.deleteSuppression d'une règle
rule.toggleActivation/désactivation d'une règle
rule.runExécution manuelle d'une règle
bulk.trashOpération bulk : mise en corbeille
bulk.deleteOpération bulk : suppression
bulk.archiveOpération bulk : archivage
bulk.labelOpération bulk : ajout de label
bulk.mark_readOpération bulk : marquer comme lu

Fail-safe

L'écriture des logs d'audit est fail-safe : une erreur d'écriture est loggée en console mais ne bloque jamais l'action principale.