Skip to main content

​
Audit Logging

Audit logs record actions taken in your organization. You can list, filter, and export them through the API or CLI.

​
Endpoints

All endpoints are under /api/v1/organizations/:orgId/audit-logs.

​
List audit logs

GET /audit-logs?limit=25&category=security&startDate=2026-01-01
Returns paginated results with items, hasMore, and nextCursor for cursor-based pagination.

​
Export

GET /audit-logs/export?format=csv&startDate=2026-01-01&endDate=2026-04-01
Supported formats: csv, json, ndjson. csv and ndjson stream results directly. json is more tightly capped and better for smaller exports.

​
Export preflight

GET /audit-logs/export/preflight?format=csv&startDate=2026-01-01&endDate=2026-04-01
Returns estimated row count and byte size before you commit to a full export. Use this for large date ranges.

​
Get single event

GET /audit-logs/:eventId

​
CLI

cloudgeni audit-log list --category security --start-date 2026-01-01
cloudgeni audit-log export --format csv --start-date 2026-01-01 --end-date 2026-04-01
CLI export streams output directly to stdout.