v37

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-1170194628.0 KB
v1
Telemetry

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"
}
```
post/v1/telemetry/events

Request body

anonymous_idstring nullable

Anonymous session ID

Response

Successful Response

successboolean required

Whether the events were successfully processed

events_receivedinteger required

Number of events received

events_processedinteger required

Number of events successfully processed

messagestring nullable

Optional message