---
title: "POST /v1/telemetry/events"
method: POST
path: "/v1/telemetry/events"
tags: ["Desktop"]
---

# POST /v1/telemetry/events

`POST /v1/telemetry/events`

## Request

- Base URL: `https://api.quillhub.ai`
- URL: `https://api.quillhub.ai/v1/telemetry/events`
- Auth: none declared

## Request body

- object
  - `events` object[], required
    - `client_event_id` string, uuid, required
    - `event_name` string, required
    - `installation_id` string, uuid, required
    - `distinct_id` string, required
    - `session_id` string, uuid, required
    - `client_sent_at` integer, required
    - `session_started_at` integer
    - `app_version` string
    - `os` 'windows' | 'macos' | 'linux'
    - `os_version` string
    - `locale` string
    - `app` 'desktop' | 'extension'
    - `properties` object, required
  - `schema_version` 'v1', required

## Response `200`

Batch processed

- object
  - `accepted` integer, required
  - `rejected` integer, required
  - `errors` object[]
    - `index` integer, required
    - `reason` string, required
  - `clamped_indexes` integer[]
  - `schema_version` 'v1', required

## Other responses

- `400`: Batch too large or malformed
- `429`: Rate limited

---

[API](https://skmtc.dev/quillhub/apis/quillhub-public-api.md) · [All operations](https://skmtc.dev/quillhub/apis/quillhub-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/quillhub/apis/quillhub-public-api/revisions/5bd42ee9d967?raw)