Audit logs
Query the history of configuration changes.
Audit log entries record changes to configuration resources over time. Each entry captures who made a change, what resource it affected, and when it happened.
These endpoints share the pagination and error conventions.
List audit log entries
/v1/audit_logsReturns a page of audit log entries, most recent first.
- page string
Pagination cursor. See pagination.
- per_page numberdefault: 20
Maximum number of entries to return.
min: 1max: 100- resource_types string[]
Return only entries for these resource types.
- resource_ids string[]
Return only entries for these resource IDs.
format: uuid- actions string[]
Return only entries for these actions.
- actors string[]
Return only entries recorded for these actors.
- occurred_after string
Return only entries that occurred after this timestamp.
format: date-time- occurred_before string
Return only entries that occurred before this timestamp.
format: date-time
The shape of each audit log entry is:
- id string
The entry ID.
format: uuid- resource_type string
The type of resource that was changed.
- resource_id string
The ID of the resource that was changed.
format: uuid- action string
The action that was performed on the resource.
- actor string
The actor that performed the action.
- metadata object
Structured context about the change, or absent when none was recorded.
- occurred_at string
When the change occurred.
format: date-time
curl 'http://localhost:8022/v1/audit_logs?per_page=20' \
-H 'X-Tenant-Id: acme'