Account

List the authenticated account's audit events

Returns the per-account audit log written transactionally with every monitor / webhook / api-key mutation plus account-level signals (suspension, notification_email change). Newest-first by (created_at DESC, id DESC). Paginated by opaque cursor — see the cursor parameter and the next_cursor response field.

Rows become eligible for deletion after 90 days by a best-effort daily sweep (not a maximum age — see internal/retention). since filters older than the 90-day cutoff are rejected with HTTP 400.

get/api/v1/account/events

Request

  • Base URL: https://api.uptimemonitoring.com
  • URL: https://api.uptimemonitoring.com/api/v1/account/events
  • Auth: HTTP bearer

Query parameters

limitinteger

Page size. Max 200.

cursorstring

Opaque base64url cursor returned as next_cursor from a previous response. Pass back verbatim — the value is URL-safe and must NOT be percent-encoded by the client. Treat as opaque; do not inspect or mutate.

event_typestring[]

Filter to specific event types. Repeatable — providing multiple values returns the union (OR). Unknown values return 400. webhook.* are historic (pre-#212) and kept for the 90-day retention window; new writes produce recipient.* and monitor.recipients_set instead. recipient.confirmed, recipient.unsubscribed, and account.email_cap_hit are issue #321 (email recipients) additions. account.identity_linked (issue #316, Google/email identity linking) and account.github_email_skipped (issue #390, GitHub email adoption/merge) were both previously omitted from this filter enum even though the store could already write account.identity_linked rows — a pre-#390 binary's unfiltered GET /api/v1/account/events (no event_type param) still serialized those rows, since filtering is the only place this enum was enforced; see internal/api/DECISIONS.md.

ref_type'monitor' | 'webhook' | 'recipient' | 'apikey'

Filter to events referring to a specific entity type. Must be paired with ref_id; providing one without the other returns 400.

ref_idinteger

Filter to events for a specific entity ID. Must be paired with ref_type.

sincestring date-time

Inclusive lower bound on created_at (RFC3339). Values older than the 90-day retention window are rejected with 400.

untilstring date-time

Exclusive upper bound on created_at (RFC3339). Must be strictly after since when both are provided.

Response

Paginated audit event list.

next_cursorstring nullable

Opaque base64url cursor for the next page, or null if this was the last page. Pass back verbatim as ?cursor= on the next request — the value is URL-safe; clients must NOT percent-encode it.

Changes

No recorded changes to this operation across all 1 revision of this API.