Enterprise
Audit Log
Immutable, append-only record of every admin action: key rotations, user changes, budget updates, and org settings.
Enterprise feature
The audit log is available on Enterprise plans.
Overview
Every mutation to keys, users, apps, orgs, and budgets is recorded in an immutable audit log. Each entry captures who did what, to which resource, when, and from where.
Audit Entry Structure
jsonAudit Entry
{
"id": "entry-uuid",
"org_id": "org-uuid",
"actor_id": "user-uuid",
"action": "key.rotate",
"resource_type": "key",
"resource_id": "key-uuid",
"metadata": { "new_key_id": "...", "overlap_hours": 24 },
"ip_address": "203.0.113.42",
"created_at": "2026-04-01T10:30:00Z"
}Tracked Actions
| Action | Resource | Description |
|---|---|---|
key.create | key | API key created |
key.revoke | key | API key revoked |
key.rotate | key | API key rotated |
user.invite | user | User invited to org |
user.role_change | user | User role updated |
user.remove | user | User removed from org |
app.create | app | Application created |
app.update | app | Application updated |
app.delete | app | Application deleted |
org.settings_update | org | Organization settings changed |
budget.create | budget | Budget created |
budget.update | budget | Budget limits modified |
budget.delete | budget | Budget deleted |
Query the Audit Log
GET
/api/v1/auditQuery audit entries with filters. Requires viewer role.
| Parameter | Type | Description |
|---|---|---|
action | string | Filter by action (e.g. key.rotate) |
resource_type | string | Filter by resource type (key, user, app, org, budget) |
actor_id | UUID | Filter by who performed the action |
resource_id | string | Filter by specific resource |
since | RFC3339 | Start of time range |
until | RFC3339 | End of time range |
limit | int | Max results (default 50, max 200) |
offset | int | Pagination offset |
bash
# Get recent key rotations
curl "https://api.ingateai.com/api/v1/audit?action=key.rotate&limit=20" \
-H "Authorization: Bearer <token>"GET
/api/v1/audit/:entryIdGet a specific audit entry by ID.