Analytics

Read delivery totals, complete time series, top files, workspace activity, and retained storage using consistent range and limit parameters.

GET/api/analytics/summary?range=7d
200 OK

Return workspace traffic and storage totals for a selected range.

Required scopeanalytics:read

Query parameters

NameTypeDescription
range24h | 7d | 30d

Aggregation window. Default 7d.

Response
{
  "range": "7d",
  "requests": 3840000,
  "bandwidthBytes": 1840000000000,
  "cacheHitRate": 96.8,
  "errors": 112,
  "errorRate": 0.0029,
  "p95Ms": 18,
  "storedBytes": 30494267801,
  "objectCount": 128
}
GET/api/analytics/series?range=7d
200 OK

Return a complete zero-filled series with 24 hourly, 7 daily, or 30 daily points.

Required scopeanalytics:read
GET/api/analytics/objects?range=24h&limit=25
200 OK

Return the most requested files, ordered by request count.

Required scopeanalytics:read
The limit is clamped from 1 to 25. Dashboard preview views do not create public delivery events.
GET/api/analytics/activity?limit=25
200 OK

Return human-readable workspace activity with actor, asset, metadata, and timestamps.

Required scopeanalytics:read
GET/api/analytics/storage
200 OK

Return storage ownership from each bucket down to current and retained revision bytes.

Required scopeanalytics:read