---
title: "Admin Summary"
method: GET
path: "/telemetry/admin/summary"
tags: ["telemetry"]
---

# Admin Summary

`GET /telemetry/admin/summary`

Aggregated telemetry for the internal admin dashboard. Admins only.

## Query parameters

- `days` integer

## Response `200`

Successful Response

- TelemetrySummaryResponse
  - `days` integer, required
  - `total_events` integer, required
  - `distinct_installs` integer, required
  - `distinct_installs_human` integer
  - `total_events_pytest` integer
  - `pytest_installs_excluded` integer
  - `returning_installs` integer
  - `returning_rate` number, nullable
  - `success_rate` number, nullable
  - `failure_rate_install_weighted` number, nullable
  - `installs_with_command_outcome` integer
  - `installs_with_error` integer
  - `interrupted_count` integer
  - `usage_error_count` integer
  - `by_command` CommandStat[], required
    - `command` string, required
    - `count` integer, required
    - `distinct_installs` integer
    - `distinct_installs_with_error` integer
    - `success_rate` number, nullable
    - `p50_ms` number, nullable
    - `p95_ms` number, nullable
    - `error_count` integer
    - `interrupted_count` integer
    - `usage_error_count` integer
  - `by_version` VersionStat[], required
    - `cli_version` string, required
    - `count` integer, required
  - `by_os` OsStat[], required
    - `os` string, required
    - `count` integer, required
  - `by_error` ErrorStat[], required
    - `error_type` string, required
    - `count` integer, required
    - `distinct_installs` integer
  - `by_tool` ToolStat[]
    - `tool` string, required
    - `count` integer, required
    - `distinct_installs` integer
    - `error_count` integer
    - `distinct_installs_with_error` integer
    - `p50_ms` number, nullable
    - `stale_share` number, nullable
    - `degraded_share` number, nullable
    - `stale_sample` integer
    - `degraded_sample` integer
  - `docs_mode` DocsModeStat — AI-docs adoption: init/update runs carrying the ``docs_mode`` flag. Three outcomes, not two. The flag used to be a boolean, but an ``init --index-only`` run renders a full wiki from templates, so "has docs" and "model wrote the docs" stopped being the same question. See ``repowise.core.docs_mode`` in the OSS engine and migration 093.
    - `total` integer
    - `with_docs` integer
    - `deterministic` integer
    - `index_only` integer
  - `daily` DailyPoint[], required
    - `day` string, required
    - `count` integer, required
    - `count_human` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/repowise/apis/repowise-hosted-api.md) · [All operations](https://skmtc.dev/repowise/apis/repowise-hosted-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/repowise/repowise-hosted-api/revisions/1e57283a9737/schema)
