audit

List the tenant's centralized audit trail

get/v1/audit-events

Request

  • Base URL: https://api.typenode.ai
  • URL: https://api.typenode.ai/v1/audit-events
  • Auth: HTTP bearer

Query parameters

resource_typestring

Comma-separated list of resource types to match (for example workflow,skill). An unrecognized value returns an empty page, never an error.

resource_idstring uuid

Filter by resource id, a UUID.

actor_type'member' | 'service_account' | 'ai_agent' | 'system'

Filter by actor type.

actor_idstring uuid

Filter by actor id, a UUID.

actionstring

Filter by action. Exact match when the value contains a dot (workflow.deploy matches only that action); namespace-scoped when it does not (workflow matches every workflow.* action).

outcome'success' | 'denied' | 'failure'

Filter by outcome.

occurred_afterstring date-time

Only events at or after this timestamp.

occurred_beforestring date-time

Only events strictly before this timestamp.

request_idstring uuid

Filter by the server-owned request UUID that produced the event. Absence proves only that no matching audit row is visible; for cross-store operations, inspect the journal because missing terminal evidence is unknown.

client_correlation_idstring

Filter by the caller-provided 32-character diagnostic correlation value. This is distinct from request, replay, and authorization identities.

trace_idstring

Filter by the lowercase, non-zero 32-character W3C trace identifier.

afterstring

Keyset cursor.

limitinteger

Page size (1-100, default 50).

Response

A page of audit events, newest first.

has_moreboolean required
next_cursorstring nullable required

Changes

No recorded changes to this operation across all 2 revisions of this API.