Nurama Developers
AccessActivity

Record a play event from the authenticated in-app player

FE-pinged on `play` and `ended` events from `EnhancedVideoPlayer` / `EnhancedAudioPlayer`. The helper de-dupes per UTC day per session, so resume-from-pause / region replays inside one session collapse into one row. `download` and `embed_resolved` are NOT accepted on this route — those are server-captured to keep the counts authoritative.

POST
/assets/{assetId}/access-activity

FE-pinged on play and ended events from EnhancedVideoPlayer / EnhancedAudioPlayer. The helper de-dupes per UTC day per session, so resume-from-pause / region replays inside one session collapse into one row. download and embed_resolved are NOT accepted on this route — those are server-captured to keep the counts authoritative.

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: assets:read

Path Parameters

assetId*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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/access-activity" \  -H "Content-Type: application/json" \  -d '{    "eventType": "play_started",    "visibility": "creator"  }'
Empty