Skip to content

Audit log

The audit log answers "what did the assistant do in my books, and who approved it?". This page lists its events and fields and what the file guarantees; turn it on before you enable a write tier (Permissions).

With SEVDESK_AUDIT_LOG=<path> the server appends one JSON line per event of every write call to that file, and in remote mode one per file that moves through an upload page or a download link. If the variable is set but the file cannot be written, writes are refused. In remote mode one log covers every account the server serves.

Events 

EventWhen
dry_runA dry run returned its preview.
confirmation_requestedA confirmation was asked for, with the preview (and in browser mode the reference code).
confirmation_refusedA retry presented a confirmation that was replayed, expired or made for other arguments.
approval_decidedApprove or Reject was pressed on an approval page.
declinedYou declined in the client, or rejected the approval in the browser.
executingThe action is about to be sent, with how it was approved: elicit, browser, confirmation_off or not_required (the write tier).
executedThe action ran; with the records it changed.
failedThe action failed; with the error kind and any records an earlier step already changed.
file_receivedRemote mode: a file was uploaded on an upload page.
file_link_createdRemote mode: a tool created a download link.
file_downloadedRemote mode: a download link was used.

Fields 

Every line starts with ts (the time, ISO 8601) and v, the version of the line format (1), followed by event. In remote mode account and grant come next. The other fields depend on the event:

FieldEventsMeaning
accountall, remote mode onlyThe sevDesk account id (in bearer mode bearer if the server could not look it up). On file lines, the account whose tool call created the upload page or link.
grantall, remote mode onlyThe OAuth grant id, or bearer.
callIdwrite eventsShared by the lines of one action, from the request to the result.
toolwrite eventsThe tool name.
tierwrite eventswrite, commit or external.
argsHashwrite eventsA hash of the tool and its arguments (without dryRun).
argswrite events except approval_decidedThe arguments: the token redacted, upload ids redacted, hidden characters written as visible \u{…} escapes, strings up to 20,000 characters.
previewHashdry_run, confirmation_requested, approval_decided, executingA hash of the preview that was shown and approved; for commit and external tools it covers the English and the German text.
previewdry_run, confirmation_requestedThe preview as shown: action (one sentence), facts (label, value), warnings and irreversible.
approvalexecutingHow the action was approved: elicit, browser, confirmation_off or not_required.
reasonconfirmation_refusedreplayed_or_expired or mismatch (made for another tool or other arguments).
decisionapproval_decidedapproved or rejected.
referencebrowser confirmation_requested, approval_decided, file eventsThe reference code shown on the page and in the tool result. Not a secret.
affectedexecuted, failedThe records changed (objectName, id); for failed, those an earlier step already changed.
errorfailedThe error kind, such as validation, not_found, auth, timeout, network, server, aborted, internal or output_invalid.
kindfile eventspdf, png, jpeg, xml, csv or zip.
bytesfile eventsThe size of the file.
sha256file eventsThe SHA-256 of the content, hex. File lines never contain the file name or the content.

A longer string in args is cut there and ends with a note of how many characters were not logged.

For example (shortened):

{  "ts": "2026-11-09T14:03:12.481Z",  "v": 1,  "event": "executed",  "callId": "6f1c…",  "tool": "sevdesk_invoice_finalize",  "tier": "commit",  "argsHash": "9b2e…",  "args": { "id": 1042, "sentVia": "email" },  "affected": [{ "objectName": "Invoice", "id": "1042" }]}

v changes only when a field changes its meaning or is removed; new fields can appear without it (Compatibility).

Integrity 

  • The file. It is created with mode 0600 (and tightened to 0600 if it already exists), opened append-only and never through a symbolic link. On macOS and Linux a file that belongs to another user is refused, whatever its mode: its owner could rewrite it, and an ACL can grant access the mode does not show.
  • Whole lines. Every line is written whole or the write fails; a short write is continued, not accepted.
  • Fail closed. If the executing line cannot be written, the action is not run and nothing is sent.
  • Not tamper-proof. The log is local: it records what this server did, for you, and is no defense against someone who controls the machine.

In remote mode the previews it records contain customer names, amounts and e-mail texts of every connected account (Privacy).