dashboards

Org actor-grain people analytics (who edits/views/logs in).

Who edits, views, and logs in — an actor-grain sibling to GET /v1/orgs/{orgId}/analytics/content (dashboard-grain) (DVT-1217). Admin or owner only (audit:read). The data object shape is frozen — field names are a client contract.

viewsSource follows the same events-vs-derived rule as the content endpoint (see its description); viewers/matrix are computed from dashboard_views when "events", else approximated from query_executions dashboard-render rows.

editsSummary is a fixed org-wide baseline (current window vs. the immediately-prior equal-length window) — it is never narrowed by any filter. actorType narrows editors/viewers/matrix; dashboardId narrows viewers/matrix only (editors and logins are not dashboard-scoped concepts). connectionId is accepted for parity with the sibling endpoints' query-string shape but is always ignored here — connections have no bearing on "who."

loginsRecordedSince is an ALL-TIME signal (not window-scoped): the earliest recorded login (successful or not) across this org's current members, or null if none is on record.

get/v1/orgs/{orgId}/analytics/people

Request

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

Query parameters

daysinteger

Rolling window in calendar days. Default 30; clamped to [1, 365]. Out-of-range or non-integer values are silently clamped/defaulted.

connectionIdstring uuid

Accepted for parity with the sibling analytics endpoints; always ignored on this endpoint. A malformed UUID is silently ignored, never a 400.

dashboardIdstring uuid

Narrow viewers and matrix to a single dashboard. Does not affect editors, editsSummary, or logins. A malformed UUID is silently ignored (no filter applied), never a 400.

actorType'user' | 'api_key' | 'agent'

Narrow editors, viewers, and matrix to a single actor type. Does not affect editsSummary or logins. Any value other than user, api_key, or agent is silently ignored (no filter applied), never a 400.

Response

Org people-analytics result.

Changes

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