Audit

Das Audit-Log hält jede Richtlinien-Entscheidung, jede Freigabe, jeden Zustandswechsel eines Runs und jeden Schreibzugriff auf den Tracker fest, mit Akteur (eine Person, kanman oder das System), Team, Run und Ergebnis. Sie lesen und exportieren es in der App oder über die REST-API. Das Dateiformat beschreibt Audit-Exportformat.

Wer es sehen kann

Inhaber und Admins öffnen Audit in der Hauptnavigation (/<workspace>/audit). Mitglieder sehen den Eintrag deaktiviert.

Das Audit-Log lesen

Die Audit-Seite listet die Einträge, neueste zuerst, mit den Spalten Zeit, Akteur, Team, Run, Ereignis und Ergebnis. Ältere Einträge laden lädt die nächste Seite.

Die Filter sind Teil der Seitenadresse, Sie können eine gefilterte Ansicht also als Lesezeichen speichern oder teilen.

Export

Klicken Sie auf Als CSV exportieren oder Als JSON exportieren. Die Datei enthält genau die Einträge, die die Seite mit Ihren Filtern zeigt, in derselben Reihenfolge. Für einen längeren Zeitraum setzen Sie Von und Bis und laden ältere Einträge, bis der Zeitraum vollständig ist. Ein Export umfasst höchstens 5.000 Einträge.

kanman hält jeden Export fest: wer exportiert hat, wann, in welchem Format und für welchen Zeitraum.

Aufbewahrung

Wie lange Einträge aufbewahrt werden, legen Admins unter Einstellungen, Audit-Aufbewahrung fest. Siehe Aufbewahrung und Löschung.

REST-API

Die Audit-Endpunkte brauchen das Token eines Owners oder Admins des Workspaces (andere Tokens erhalten 403). Beide nehmen die Filter der Audit-Seite: team (Team-Slug), actor (human, kanman oder system), event (ein Event-Typ), run (Run-Schlüssel), from und to (JJJJ-MM-TT oder ein ISO-Zeitstempel).

Einträge lesen

GET /v1/audit liefert Einträge, die neuesten zuerst, seitenweise. Jeder Eintrag hat id, timestamp, actor (type, name, userId), team, runKey, event, result, entity (type, id, name) und details.

curl "https://api.kanman.ai/functions/v1/api-gateway/v1/audit?team=sandbox-team&event=decision_resolved&from=2026-10-01" \
  --header "Authorization: Bearer $KANMAN_API_KEY"

Einträge exportieren

GET /v1/audit/export?format=csv (oder format=json) liefert eine Datei im Audit-Exportformat mit bis zu 5.000 Einträgen, die neuesten zuerst. Der Header X-Kanman-Export-Count nennt die Zahl der Einträge, X-Kanman-Export-Truncated: true zeigt, dass mehr passten: Grenzen Sie from und to ein und exportieren Sie erneut. Jeder Export wird wie ein Export aus der App festgehalten.

curl "https://api.kanman.ai/functions/v1/api-gateway/v1/audit/export?format=csv&from=2026-09-01&to=2026-09-30" \
  --header "Authorization: Bearer $KANMAN_API_KEY" --output audit-september.csv