---
title: "Telemetry Events"
method: POST
path: "/v1/telemetry/events"
tags: ["v1", "Telemetry"]
---

# Telemetry Events

`POST /v1/telemetry/events`

Telemetry proxy endpoint for anonymous OSS adoption tracking.
    
    This endpoint receives telemetry events from OSS installations and forwards them
    to Amplitude using Papr's API key (which stays secure on the server).
    
    **Privacy**:
    - All user IDs are hashed/anonymized
    - No PII is collected
    - Data is used only for understanding OSS adoption patterns
    
    **Opt-in**: Users must explicitly enable telemetry in their OSS installation.
    
    **Request Body**:
    ```json
    {
      "events": [
        {
          "event_name": "memory_created",
          "properties": {
            "type": "text",
            "has_metadata": true
          },
          "user_id": "hashed_user_id",
          "timestamp": 1234567890000
        }
      ],
      "anonymous_id": "session_id"
    }
    ```

## Request body

- TelemetryRequest — Request body for telemetry endpoint
  - `events` TelemetryEvent[], required — List of telemetry events to track
    - `event_name` string, required — Event name (e.g., 'memory_created', 'search_performed')
    - `properties` object, nullable — Event properties (will be anonymized)
    - `user_id` string, nullable — Anonymous user ID (hashed)
    - `timestamp` integer, nullable — Event timestamp (Unix epoch in milliseconds)
  - `anonymous_id` string, nullable — Anonymous session ID

## Response `200`

Successful Response

- TelemetryResponse — Response from telemetry endpoint
  - `success` boolean, required — Whether the events were successfully processed
  - `events_received` integer, required — Number of events received
  - `events_processed` integer, required — Number of events successfully processed
  - `message` string, nullable — Optional message

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/papr-ai/apis/papr-memory-api.md) · [All operations](https://skmtc.net/papr-ai/apis/papr-memory-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/papr-ai/papr-memory-api/versions/b553be9aad37/schema)