Audit Log
List Audit Log
Returns paginated audit log entries for a project.
GET
All management actions (flag changes, key creation, approvals, etc.) are recorded. Entries are append-only and immutable.
Retention: Free plan returns only the last 7 days. Pro/Enterprise returns full history.
Each
Path parameters
Query parameters
Page size. 1–100, default 50.
Timestamp cursor for the next page.
Filter by resource type, e.g.
flag, api_key, proposal.Filter by a specific resource ID.
Response fields
AuditLogEntry:
| Field | Type | Description |
|---|---|---|
id | string | |
actorId | string | API key ID or session user ID |
actorType | "api_key" | "user" | |
action | string | e.g. flag.version.created, api_key.revoked |
resourceType | string | e.g. flag, flag_version, proposal |
resourceId | string | |
meta | object | Action-specific metadata (see table below) |
createdAt | string | ISO 8601 |
meta shapes by action
action | meta fields |
|---|---|
flag.created | { key, name, type } |
flag.updated | { name?, description?, clientSafe?, archivedAt? } |
flag.version.created | { flagKey, envId, version } |
flag.proposal.created | { flagKey, envId } |
flag.proposal.approved | { flagKey, envId, version } |
flag.proposal.rejected | { envId } |
environment.created | { name, slug } |
environment.updated | subset of { name, color, protected } |
project.created | { name, slug } |
api_key.created | { type, description, keyPrefix } |
api_key.revoked | { keyPrefix } |