---
title: "Receive client telemetry"
method: POST
path: "/api/v1/telemetry"
---

# Receive client telemetry

`POST /api/v1/telemetry`

Accepts batches of SDK telemetry events for analytics and diagnostics

## Request body

- TelemetryBatch
  - `sdk_version` string, required — SDK version string
  - `platform` string, required — Host platform name
  - `session_id` string, uuid, required
  - `events` TelemetryEvent[], required
    - union
      - SessionStartEvent
        - `event` 'SESSION_START' | 'SESSION_END' | 'UNHANDLED_EXCEPTION', required — Telemetry event type
        - `timestamp` string, date-time, required
        - `severity` 'DEBUG' | 'INFO' | 'WARNING' | 'ERROR' | 'CRITICAL', required — Log severity level
        - `event_id` string, uuid, required
        - `event_session_index` integer, required
      - SessionEndEvent
        - `event` 'SESSION_START' | 'SESSION_END' | 'UNHANDLED_EXCEPTION', required — Telemetry event type
        - `timestamp` string, date-time, required
        - `severity` 'DEBUG' | 'INFO' | 'WARNING' | 'ERROR' | 'CRITICAL', required — Log severity level
        - `event_id` string, uuid, required
        - `event_session_index` integer, required
        - `duration` string, required — ISO 8601 duration string
      - UnhandledExceptionEvent
        - `event` 'SESSION_START' | 'SESSION_END' | 'UNHANDLED_EXCEPTION', required — Telemetry event type
        - `timestamp` string, date-time, required
        - `severity` 'DEBUG' | 'INFO' | 'WARNING' | 'ERROR' | 'CRITICAL', required — Log severity level
        - `event_id` string, uuid, required
        - `event_session_index` integer, required
        - `error_type` string, required
        - `error_message` string, required
        - `traceback` string, nullable — Optional Python traceback string

## Response `202`

Telemetry accepted

- TelemetryResponse
  - `status` 'accepted', required

---

[API](https://skmtc.dev/thinking-machines-lab/apis/tinker-api.md) · [All operations](https://skmtc.dev/thinking-machines-lab/apis/tinker-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thinking-machines-lab/tinker-api/revisions/51afac49fce6/schema)