---
title: "One-shot envelope of every knowledge analytics pipe"
method: GET
path: "/v1/analytics/knowledge/dashboard"
tags: ["analytics"]
---

# One-shot envelope of every knowledge analytics pipe

`GET /v1/analytics/knowledge/dashboard`

## Query parameters

- `granularity` string
- `knowledge_base_id` string, nullable
- `source_type` string, nullable
- `hash_method` string, nullable
- `start_date` string, date, required
- `end_date` string, date, required

## Response `200`

Successful Response

- KnowledgeDashboardEnvelope — Single envelope returned by ``/v1/analytics/knowledge/dashboard``.
  - `adoption` KbAdoptionRow[], required
    - `knowledge_base_id` string, required
    - `documents_active` integer, required
    - `documents_failed` integer, required
    - `documents_attempted` integer, required
    - `adoption_rate_pct` number, required
    - `unique_documents` integer, required
  - `ingestion` DocumentIngestionTimeseriesRow[], required
    - `time_bucket` string, date-time, required
    - `created` integer, required
    - `completed` integer, required
    - `failed` integer, required
    - `success_rate_pct` number, required
  - `latency` DocumentProcessingLatencyRow[], required
    - `time_bucket` string, date-time, required
    - `terminal_events` integer, required
    - `p50_ms` number, required
    - `p90_ms` number, required
    - `p95_ms` number, required
    - `p99_ms` number, required
    - `avg_ms` number, required
    - `max_ms` number, required
  - `cleanup` DocumentCleanupSummaryRow[], required
    - `time_bucket` string, date-time, required
    - `failed` integer, required
    - `archived` integer, required
    - `cleaned_up` integer, required
    - `recovered` integer, required
    - `net_unrecovered_failures` integer, required
    - `cleanup_rate_pct` number, required
  - `retrieval` DocumentRetrievalTimeseriesRow[], required
    - `time_bucket` string, date-time, required
    - `total` integer, required
    - `hits` integer, required
    - `misses` integer, required
    - `reranked` integer, required
    - `errors` integer, required
    - `hit_rate_pct` number, required
    - `avg_results` number, required
    - `avg_duration_ms` number, required
    - `p50_ms` number, required
    - `p90_ms` number, required
    - `p95_ms` number, required
    - `p99_ms` number, required
  - `inventory` InventoryEnvelope, required
    - `summary` KbInventoryRow, required
      - `total_documents` integer, required
      - `total_chunks` integer, required
      - `total_tokens` integer, required
      - `normalized_pct` number, required
      - `documents_failed_now` integer, required
      - `documents_processing_now` integer, required
      - `knowledge_bases_count` integer, required
    - `by_source_type` InventoryBySourceTypeRow[], required
      - `source_type` string, required
      - `documents` integer, required
      - `chunks` integer, required
      - `tokens` integer, required
    - `by_hash_method` InventoryByHashMethodRow[], required
      - `hash_method` string, required
      - `documents` integer, required
      - `chunks` integer, required
      - `tokens` integer, required
    - `growth` InventoryGrowthRow, required
      - `created_24h` integer, required
      - `created_7d` integer, required
      - `created_30d` integer, required
      - `failed_7d` integer, required
      - `cleaned_up_7d` integer, required
  - `freshness` ConnectorFreshnessRow[], required
    - `knowledge_base_source_id` string, required
    - `knowledge_base_id` string, required
    - `provider` string, required
    - `last_status` string, required
    - `last_event_type` string, required
    - `last_sync_started_at` string, date-time, nullable
    - `last_sync_completed_at` string, date-time, nullable
    - `last_duration_ms` number, nullable
    - `last_items_processed` integer, required
    - `last_items_succeeded` integer, required
    - `last_items_failed` integer, required
    - `last_items_unchanged` integer, required
    - `last_error_message` string, nullable
    - `last_event_at` string, date-time, required
    - `time_since_last_event_seconds` integer, required

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/versions/888bdd5c076e/schema)