Audit log
These endpoints need a Keycloak access token with the admin platform role. On a multi-organization install, an organization admin can read their own organization's events. See Audit log for what is recorded.
Read events
GET
/audit-logEvents, newest first.
Query parameters
actionstringoptionalOnly this action, such as
chat or approve_tool_call.actorstringoptionalOnly events by this actor, a Keycloak user ID or
system.tenant_idstringoptionalOnly events for this project or tenant.
decisionstringoptionalallow or deny.sincestringoptionalOnly events at or after this time, in ISO 8601.
untilstringoptionalOnly events at or before this time, in ISO 8601.
limitintegeroptionalUp to 1,000. Default 100.
offsetintegeroptionalHow many matching events to skip. Default 0.
Response fields
events[].sequenceintegeroptionalThe event's place in the chain.
events[].actorstringoptionalWho did it.
events[].actionstringoptionalWhat was done.
events[].resourceobjectoptionalWhat it was done to.
events[].decisionstring or nulloptionalallow, deny or null.events[].metadataobject or nulloptionalExtra detail.
events[].tenant_idstring or nulloptionalThe project the event belongs to. Model calls carry no project and show
unknown.events[].created_atstringoptionalWhen it was written.
events[].prev_hashstringoptionalThe previous event's hash.
events[].event_hashstringoptionalThis event's hash.
Responses
200
The events.
403
Not a platform admin.
502
The audit service could not be reached.
Verify the chain
GET
/audit-log/verifyRecomputes every event's hash from the start of the chain.
Response fields
validbooleanoptionaltrue if every event and every link is intact.broken_at_sequenceinteger or nulloptionalThe first event where the chain breaks.
checkedintegeroptionalHow many events were checked.
Checkpoints, SIEM export and retention
All platform admin. Every change made here is itself an audit event, with secrets reduced to "set" or "not set". See Audit log.
| Method and path | What it does |
|---|---|
GET /audit-log/checkpoints | The newest signed checkpoints, up to limit (default 20, at most 500). |
POST /audit-log/checkpoints | Sign the chain head now. |
GET /audit-log/keys | The key ids and Ed25519 public keys, for verifying exported checkpoints elsewhere. |
GET /audit-log/export | The SIEM sinks and each one's progress. |
PUT /audit-log/export/sinks | {"sinks": [...]}: replace the sinks managed in the console. Each sink has an id, name, type (syslog, webhook, splunk_hec or s3), enabled and its type's settings. |
POST /audit-log/export/sinks/{sink_id}/test | Send a test event to a sink. |
GET /audit-log/retention | The retention in force, and its minimum. |
PUT /audit-log/retention | {"days": 730}. 0 keeps events forever. Never below the minimum. |
Was this page helpful?