Skip to API content
TalkLabs API Docs v3
Recipes
POST Live telemetry

Submit telemetry in a batch

Submit multiple telemetry actions in one request.

POST /api/v3/{appid}/telemetry/contexts/{contextid}/batch

Submit multiple telemetry actions in one request.

Buffer counter increments, gauge samples, and presence heartbeats on the client, then flush them together to reduce request overhead. Invalid items are reported without discarding valid items in the same batch.

Request

Parameters

Values in the path and query string.

appid path
string TalkLabs ID required

The TalkLabs application ID assigned to your account.

Example: your-app-id
contextid path
string customer-defined required

A customer defined ID for the live context being measured.

Request

JSON body

Send as application/json.

userId
string customer-defined required

Default user for items that do not set their own userid .

ops
TelemetryBatchItemFormModel[] required

The actions to apply. Capped server side see the controller docs .

Request example
{
  "userId": "u-8842",
  "ops": [
    "<ops>"
  ]
}
Response

Status codes

Every JSON response uses the API result envelope.

200 OK ApiResult
400 Bad Request ApiResult
403 Forbidden ApiResult
500 Internal Server Error ApiResult
Search all 118 endpoints Try “join room”, “moderate”, or “POST”.
Request environment

Connect your application

These values fill request examples and the API console. They stay in this browser tab and are never sent to TalkLabs until you run a request.

Credentials are stored in sessionStorage, not in cookies or analytics.