---
title: "Get Usage Dashboard"
method: GET
path: "/api/admin/usage"
tags: ["admin"]
---

# Get Usage Dashboard

`GET /api/admin/usage`

Get team usage dashboard.

Requires admin access. Returns usage metrics for:
- Chats by user (combined Slack + UI, from initiated_by_email)
- Manual investigations by user (from initiated_by_slack_user_id)
- PostHog active users (filtered by team domain)

## Query parameters

- `time_filter` 'daily' | 'weekly' | 'all_time' — Time filter options for usage queries.

## Response `200`

Successful Response

- UsageDashboardResponse — Complete usage dashboard response.
  - `time_filter` 'daily' | 'weekly' | 'all_time', required — Time filter options for usage queries.
  - `chats` ChatUsage, required — Combined Slack + UI chat usage by user.
    - `users` UserUsageMetric[], required
      - `identifier` string, required
      - `email` string, nullable
      - `is_bot` boolean
      - `count` integer, required
    - `total_count` integer, required
  - `investigations` InvestigationUsage, required — Manual investigation usage by user.
    - `users` UserUsageMetric[], required
      - `identifier` string, required
      - `email` string, nullable
      - `is_bot` boolean
      - `count` integer, required
    - `total_count` integer, required
  - `posthog` PostHogUsage, required — PostHog active users for the team with DAU/WAU counts and page views.
    - `daily_active_users` integer, required
    - `weekly_active_users` integer, required
    - `page_views` integer, required
    - `total_unique_users` integer, required
    - `users` PostHogActiveUser[], required
      - `email` string, required
      - `event_count` integer, required
    - `configured` boolean, required
    - `error` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/deeptrace/apis/fastapi.md) · [All operations](https://skmtc.net/deeptrace/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deeptrace/fastapi/versions/2e2a6de8aeda/schema)