Organization-wide audit log: the operator-facing event stream across every entity, with full actor and cascade-chain detail.
List audit events
Returns a paginated, filtered audit log for the calling organization. Replaces the old per-entity state-transition feed: every domain event lands in audit_events, with state.transitioned as one event_type among many. Default page size is 25, max 100.
query Parameters
limitPage size. Values above the server-side cap are clamped (standard default 50, cap 200; a few document-heavy lists use larger windows). Invalid values fall back to the default.
cursorOpaque continuation token from the previous response's pagination.cursor. Omit for the first page. Cursors are stateless and do not expire, but are only valid for the list and filters that produced them.
entity_typeFilter by entity type (e.g. customer, invoice, subscription)
Filter by entity type (e.g. customer, invoice, subscription)
entity_idFilter by entity UUID
Filter by entity UUID
event_typeFilter by event type. Repeatable (?event_type=a&event_type=b) or comma-separated (?event_type=a,b).
Filter by event type. Repeatable (?event_type=a&event_type=b) or comma-separated (?event_type=a,b).
actor_typeFilter by actor type: user | api_key | system | job | webhook | unknown
Filter by actor type: user | api_key | system | job | webhook | unknown
actor_user_idFilter by acting user id
Filter by acting user id
occurred_afterFilter by occurred_at >= timestamp (RFC3339)
Filter by occurred_at >= timestamp (RFC3339)
occurred_beforeFilter by occurred_at <= timestamp (RFC3339)
Filter by occurred_at <= timestamp (RFC3339)
Headers
X-Workspace-IdSelects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.
Workspace UUID or slug.
List audit events › Responses
OK