Nurama Developers
AccessActivity

Top-N assets in a project by access count

Returns `(assetId, count)` pairs ordered by total count of the requested `eventType` in the range. The endpoint stays minimal on purpose — the FE hydrates names / thumbnails via the existing asset reads so this surface doesn't get coupled to the asset projection. Gated by `canGetAccessActivity`.

GET
/projects/{projectId}/access-activity/top-assets

Returns (assetId, count) pairs ordered by total count of the requested eventType in the range. The endpoint stays minimal on purpose — the FE hydrates names / thumbnails via the existing asset reads so this surface doesn't get coupled to the asset projection. Gated by canGetAccessActivity.

Authorization

AuthorizationBearer <token>

OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.

In: header

Scope: projects:read

Path Parameters

projectId*string
Match^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Formatuuid

Query Parameters

range?string
Default"30d"

Value in

  • "7d"
  • "30d"
  • "90d"
eventType?string
Default"play_started"

Value in

  • "play_started"
  • "play_completed"
  • "download"
  • "embed_resolved"
limit?integer
Range1 <= value <= 50
Default10

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/access-activity/top-assets"
{  "range": "string",  "from": "string",  "to": "string",  "eventType": "string",  "results": [    {      "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",      "count": 0    }  ]}