---
title: "Ingest a daily on-prem telemetry snapshot"
method: POST
path: "/onprem/v1/telemetry"
tags: ["onprem", "onprem", "__public__"]
---

# Ingest a daily on-prem telemetry snapshot

`POST /onprem/v1/telemetry`

## Headers

- `X-Definite-License` string, nullable

## Request body

- TelemetryRequest — Daily aggregate snapshot, exactly as the on-prem telemetry job builds it (`defonprem.telemetry.TelemetryService.collect`). Counts and sizes only. `extra="allow"` so a future on-prem snapshot field (the payload is `schema_version`-tagged) does not 422 an older central API.
  - `schema_version` integer, required — Snapshot payload schema version
  - `captured_at` string, date-time, required — When the on-prem job built the snapshot
  - `deployment` object — Deployment block
  - `structure` object — Table/object counts
  - `data_scale` object — Data-size aggregates
  - `usage_24h` object — Last-24h activity counts
  - `activity` TelemetryActivityBlock — Fail-closed lifecycle signals emitted by telemetry schema v4+. Wire names use ``login``/``tracking`` while promoted database columns use ``activity_tracking_*``; :class:`OnPremTelemetryTableClient` owns that explicit mapping and stores the original wire payload unchanged.
    - `login_tracking_authoritative` boolean
    - `workload_inventory_authoritative` boolean
    - `tracking_started_at` string, date-time, nullable
    - `first_customer_login_at` string, date-time, nullable
    - `last_customer_login_at` string, date-time, nullable
    - `customer_login_count` integer
    - `scheduled_automation_count` integer
    - `scheduled_agent_count` integer
  - `billing` TelemetryBillingBlock — Credit-oriented rollup emitted by the on-prem telemetry job. The hosted billing bridge is intentionally implemented separately; central ingestion only validates and stores these numbers in this service.
    - `mode` 'self_hosted' | 'definite_hosted', nullable
    - `metering_tier` string, nullable
    - `query_compute_seconds_24h` number, nullable
    - `llm_tokens_24h` integer, nullable
    - `llm_token_meter_version` integer, nullable
    - `llm_input_tokens_24h` integer, nullable
    - `llm_cache_read_tokens_24h` integer, nullable
    - `llm_cache_write_tokens_24h` integer, nullable
    - `llm_output_tokens_24h` integer, nullable
    - `estimated_compute_credits_24h` number, nullable
    - `estimated_ai_credits_24h` number, nullable
  - `compute_meter` TelemetryComputeMeterBlock — Cumulative compute meter that survives missed daily snapshots.
    - `meter_version` integer, required
    - `meter_instance_id` union, required
      - string, uuid
      - string
    - `high_watermark` integer, required
    - `event_count_total` integer, required
    - `duration_ms_total` integer, required
    - `cpu_millicore_ms_total` integer, required
    - `memory_byte_ms_total` integer, required
    - `totals_by_source` object

## Response `200`

Success

- SuccessResponseTelemetryResponse
  - `success` true, required — Flag for it request was successful
  - `data` TelemetryResponse, required
    - `status` string — Ingest outcome
    - `license_status` string, required — active | suspended | revoked | expired — current license state
    - `compute_meter_status` string, nullable — baselined | accepted | duplicate | regression
    - `compute_meter_instance_id` union
      - string, uuid
      - string
    - `accepted_compute_high_watermark` integer, nullable
    - `capacity_summary` object, nullable — Latest centrally authoritative provisioned-capacity totals
  - `meta` ResponseMeta
    - `requestId` string — Unique request identifier for tracing
    - `timestamp` string, date-time — Response timestamp (UTC)
    - `durationMs` integer, nullable — Request processing time in milliseconds

## Other responses

- `401` — Auth Invalid Token
- `403` — Forbidden Insufficient Permissions
- `404` — Resource Not Found
- `422` — Validation Failed
- `426` — Business Quota Exceeded
- `429` — Rate Limit Exceeded
- `500` — Internal Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/3943d8deb3be/schema)