Skip to content

Audit

Lire par l'API publique le journal d'audit des actions menées dans votre organisation et votre application.

ReferenceDeveloperAdministrator

This page has not been translated yet and is shown in French.

Wakastart trace les actions sensibles (connexions, créations et modifications d'utilisateurs, d'équipes, de profils, invitations…) dans le journal d'audit. L'API publique en donne une lecture limitée à votre périmètre ; l'écran complet, avec la vérification d'intégrité et l'export, est décrit dans Journal d'audit.

Accès : tout appelant authentifié par jeton Keycloak, jeton enrichi ou clé API. Aucun droit ni niveau d'administration particulier n'est exigé.

Les événements renvoyés sont toujours limités à l'application de l'appelant et à son périmètre : toute l'application pour un Propriétaire, son réseau pour un Administrateur réseau, son client sinon.

L'objet Événement d'audit

ChampTypeDescription
idchaîne (24)Identifiant de l'événement
timestampchaîne ISO 8601Date de l'action
context.originchaîneService ou écran à l'origine de l'action
context.app-idchaîneApplication concernée
context.actionchaîneAction tracée, par exemple USER_INVITED ou USER_DISABLED
context.severitychaînecritical, error, alert, warning ou info
descriptionchaîneDescription lisible de l'action
infochaîneDétails complémentaires
ipchaîneAdresse IP de l'auteur
user-idchaîneAuteur de l'action
admin-levelchaîneNiveau d'administration de l'auteur
partner-wid, network-wid, customer-widchaînePropriétaire, réseau et client concernés
partner-id, network-id, customer-idUUIDMêmes rattachements, en identifiants techniques

Les champs absents d'un événement sont omis.

Lister les événements

GET/api/audit-logs
Paramètre de requêteTypeDéfautDescription
pageentier ≥ 11Page
limitentier, 1 à 10020Taille de page
actionchaîne—Ne garde que cette action
userIdUUID, WID ou identifiant de 24 caractères—Ne garde que les actions de cet auteur
Bash
curl -s "https://api.wakastart.app/api/audit-logs?action=USER_INVITED&limit=50" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Réponse 200

JSON
{
  "data": [
    {
      "id": "6718c2a9f1e2d3c4b5a69788",
      "timestamp": "2026-10-23T09:02:11.000Z",
      "context": { "origin": "invitations", "app-id": "EXAPP1", "action": "USER_INVITED", "severity": "info" },
      "description": "Invitation envoyée à chloe@clinique-exemple.fr",
      "ip": "203.0.113.24",
      "user-id": "6c1f2a9e-4b1d-4e0b-9a51-2f6c3d7e8a10",
      "admin-level": "CUSTOMER_ADMIN",
      "network-wid": "EXNET1",
      "customer-wid": "EXCLI1"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 50,
  "totalPages": 1
}

La réponse de cette liste est à plat (total, page, limit, totalPages au même niveau que data), contrairement aux listes de l'organisation (voir Pagination).

Erreurs

StatutMessageCause
401Token enrichi valide requis — authentifiez-vous avec un Bearer token ou une clé API valideAucune identité valide
403Impossible de déterminer le scope tenant pour la consultation des logs d'auditL'appelant n'est rattaché à aucun client, réseau ni propriétaire
503Service in degraded mode: MongoDB is not connectedJournal momentanément indisponible

Les événements sont conservés 3 ans.