Send Telemetry Events

Prev Next
Post
/api/v1/statistics.telemetry

Send one or more telemetry events to the workspace. Each event increases a usage counter that is stored as a workspace setting.

The workspace processes the events in the order you send them. If an event has an unknown eventName, the request fails with event not found, but the events before it in the list are still processed.

Changelog

Version Description
4.6.0 Added
Header parameters
X-Auth-Token
stringRequired

The token of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-Id
stringRequired

The user ID of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ
Body parameters
Slash Command Event
{
  "params": [
    {
      "eventName": "slashCommandsStats",
      "timestamp": 1759920000000,
      "command": "jitsi"
    }
  ]
}
Settings Counter Event
{
  "params": [
    {
      "eventName": "updateCounter",
      "settingsId": "Engagement_Dashboard_Load_Count"
    }
  ]
}
Expand All
object
params
Array of object Required

The list of telemetry events to send. Each event is an object.

Example[ { "eventName": "slashCommandsStats", "command": "jitsi" } ]
object
eventName
string Required

The event type. Either slashCommandsStats or updateCounter.

Valid values[ "slashCommandsStats", "updateCounter" ]
ExampleslashCommandsStats
timestamp
number

The time the event happened, as a Unix timestamp in milliseconds.

Example1759920000000
command
string

The slash command that was run, without the leading /. Use with the slashCommandsStats event. The jitsi command increases the Jitsi_Start_SlashCommands_Count setting by 1. Other commands return a success response but don't change any counter.

Examplejitsi
settingsId
string

The ID of the counter setting to increase by 1. Use with the updateCounter event.

ExampleEngagement_Dashboard_Load_Count
Responses
200

OK

Example 1
{
  "success": true
}
object
success
boolean
400

Bad Request

Missing Params
{
  "success": false,
  "error": "must have required property 'params'",
  "errorType": "error-invalid-params"
}
Invalid Params Type
{
  "success": false,
  "error": "must be array",
  "errorType": "error-invalid-params"
}
Missing Event Name
{
  "success": false,
  "error": "must have required property 'eventName'",
  "errorType": "error-invalid-params"
}
Invalid Timestamp Type
{
  "success": false,
  "error": "must be number",
  "errorType": "error-invalid-params"
}
Unknown Body Property
{
  "success": false,
  "error": "must NOT have additional properties",
  "errorType": "error-invalid-params"
}
Unknown Event
{
  "success": false,
  "error": "event not found"
}
object
success
boolean
error
string
errorType
string
401

Unauthorized

Authorization Error
{
  "success": false,
  "error": "You must be logged in to do this."
}
object
success
boolean
error
string