1. Submit Telemetry Report
Push a daily rollup of numeric counters to the platform.Request Body Schema
The request must contain only the following whitelist fields. Extra fields are rejected immediately to protect privacy.Example Request Body
Processing Gates
- Opt-In Enforcement: The server retrieves the user’s dashboard settings. If
telemetry_opt_inis not explicitlytrue, the write is rejected with403 telemetry_disabled. - Strict Whitelisting: If the request contains any keys outside the whitelist (e.g.
memory_contents,metadata), it is rejected with400 non_aggregate_field. - Postgres Upsert: Statistics are upserted into the database. A unique constraint on
(user_id, window_start)aggregates inputs to a single row per day.