dashboards

Recent org activity.

The organization's content-authoring activity feed, newest first, fully paginated via limit + cursor (DVT-1798, the same keyset convention as GET /v1/dashboards/{id}/activity) — meta.nextCursor carries the token for the next page when older events exist, and is absent/null on the last page. Scoped to create/update/delete/move/reorder on dashboards, sheets, pages, elements, and folders; operational audit rows (connection and credential events, renders, diffs, sharing, exports) are recorded in the audit log but excluded here. Entries carry the actor's display name and a best-effort resource label (the dashboard title, when resolvable). Events older than the audit_logs.org_id migration (0010) are unattributed and not returned.

Optionally merges in grouped dashboard-view digests (DVT-1419), sourced from dashboard_views rather than the audit log: one synthetic entry per (dashboard, UTC calendar day) with action: "view.group", carrying viewCount/otherViewerCount. This digest is high-frequency read telemetry and is excluded by default (DVT-1800) — set includeViews=true to opt in. When included, because these synthetic rows aren't part of the audit keyset, they're overlaid on the first page only (when no cursor is supplied), interleaved with the audit-derived entries by createdAt; subsequent pages are pure audit events. ListGroupedRecent only ever returns the most-recent buckets, so no view digest is lost by this.

Requires the audit:read capability (admin or owner in the fixed Community role map, ADR-0025); viewers and editors receive 403.

get/v1/orgs/{orgId}/activity

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/v1/orgs/{orgId}/activity
  • Auth: one of:
    • API key in cookie dvt_session
    • HTTP bearer

Query parameters

limitinteger

Page size. Default 20. An integer outside [1, 100] (or a non-integer) is rejected with 400.

cursorstring

Opaque keyset cursor from a prior response's meta.nextCursor. Omit to start from the newest event. A malformed cursor is rejected with 400. The grouped dashboard-view digest is included only on the first (cursor-less) page.

includeViewsboolean

Opt in to the grouped dashboard-view digest (DVT-1800). Default false: the feed is pure content-authoring activity. Set to true to overlay the view.group digest on the first page. Any value other than true is treated as false.

actorIdstring uuid

Only events by this user (uuid). A non-uuid value is rejected with 400.

actionstring

Only events with exactly this action, e.g. update or page.create. Narrows the feed's content-authoring allowlist; it cannot surface actions the feed excludes.

objectTypestring

Only events on this resource type, e.g. dashboard or sheet.

sincestring date-time

Only events at or after this instant (RFC 3339). A value that does not parse, or a since after until, is rejected with 400.

untilstring date-time

Only events at or before this instant (RFC 3339). Same 400 rules as since.

Response

A page of recent audit events, newest first.

Example response

{
  "data": [
    {
      "action": "dashboard.update",
      "resourceType": "dashboard"
    }
  ]
}

Changes

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