Ingest Telemetry Batch

Ingest anonymous telemetry batch from browser extensions.

Privacy-First Design:

• No PII collected
• Queries are SHA-256 hashed (irreversible)
• Only aggregated data exposed
• GDPR/CCPA compliant

Idempotency: Event IDs are tracked to prevent duplicate processing.

Request Body:

• events: List of 1-100 anonymous telemetry events

Example Request:

{
    "events": [
        {
            "event_id": "550e8400-e29b-41d4-a716-446655440000",
            "timestamp": "2026-01-15T10:30:00Z",
            "ai_source": "chatgpt",
            "query_tokens_hash": "a" * 64,
            "token_count": 8,
            "query_type": "product",
            "language": "en",
            "mentions": [
                {
                    "entity": "OpenAI",
                    "entity_type": "company",
                    "position_in_results": 2,
                    "sentiment": "positive"
                }
            ],
            "engaged": true,
            "time_on_results_sec": 45,
            "user_region": "US",
            "user_cohort_id": "cohort_abc123",
            "extension_version": "1.0.0"
        }
    ]
}

Response:

{
    "status": "success",
    "events_processed": 1,
    "events_failed": 0,
    "errors": []
}