ingestPlayerTelemetry
POST
/api/v1/player/telemetry
const url = 'https://example.com/api/v1/player/telemetry';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"observedAt":"2026-04-15T12:00:00Z","currentItemId":"example","itemStartedAt":"2026-04-15T12:00:00Z","lastMeaningfulProgressAt":"2026-04-15T12:00:00Z","playbackStallDurationMs":1,"stallReason":"example","rendererState":"example","rendererResponding":true,"expectedMotion":true,"serverRoundTripMs":1,"downloadQueueCount":1,"bytesRemaining":1,"cacheUsedBytes":1,"cacheLimitBytes":1,"freeStorageBytes":1,"processUptimeSeconds":1,"deviceUptimeSeconds":1}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/v1/player/telemetry \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "observedAt": "2026-04-15T12:00:00Z", "currentItemId": "example", "itemStartedAt": "2026-04-15T12:00:00Z", "lastMeaningfulProgressAt": "2026-04-15T12:00:00Z", "playbackStallDurationMs": 1, "stallReason": "example", "rendererState": "example", "rendererResponding": true, "expectedMotion": true, "serverRoundTripMs": 1, "downloadQueueCount": 1, "bytesRemaining": 1, "cacheUsedBytes": 1, "cacheLimitBytes": 1, "freeStorageBytes": 1, "processUptimeSeconds": 1, "deviceUptimeSeconds": 1 }'Ingest a player telemetry snapshot. Requires an authenticated player credential.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
observedAt
required
string format: date-time
currentItemId
string
itemStartedAt
string format: date-time
lastMeaningfulProgressAt
string format: date-time
playbackStallDurationMs
integer
stallReason
string
rendererState
string
rendererResponding
boolean
expectedMotion
boolean
serverRoundTripMs
integer
downloadQueueCount
integer
bytesRemaining
integer
cacheUsedBytes
integer
cacheLimitBytes
integer
freeStorageBytes
integer
processUptimeSeconds
integer
deviceUptimeSeconds
integer
Examplegenerated
{ "observedAt": "2026-04-15T12:00:00Z", "currentItemId": "example", "itemStartedAt": "2026-04-15T12:00:00Z", "lastMeaningfulProgressAt": "2026-04-15T12:00:00Z", "playbackStallDurationMs": 1, "stallReason": "example", "rendererState": "example", "rendererResponding": true, "expectedMotion": true, "serverRoundTripMs": 1, "downloadQueueCount": 1, "bytesRemaining": 1, "cacheUsedBytes": 1, "cacheLimitBytes": 1, "freeStorageBytes": 1, "processUptimeSeconds": 1, "deviceUptimeSeconds": 1}Responses
Section titled “ Responses ”Telemetry accepted
Media typeapplication/json
object
data
required
object
accepted
required
boolean
Example
{ "data": { "accepted": true }}Telemetry invalid
Credential invalid or revoked
Telemetry timestamp or interval invalid