---
title: "Team adoption & tool usage: every member, per client"
method: GET
path: "/analytics/v1/live/team"
tags: ["analytics"]
---

# Team adoption & tool usage: every member, per client

`GET /analytics/v1/live/team`

## Request

- Base URL: `https://api.qualityclouds.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.qualityclouds.ai/analytics/v1/live/team`
- Auth: one of:
  - HTTP bearer
  - OpenID Connect (`https://account.qualityclouds.com//realms/ai-production/.well-known/openid-configuration`)

One row per developer × client with checks in the period, then members with no check in the period (idle), then members with no editor connected. Self-only: a contributor sees their own rows unless an admin turned the team view on. With a client selected, idle rows are left out. The badges are workspace figures.

## Query parameters

- `weeks` integer: Length of the period in ISO weeks. One of [4, 8, 12, 26].
- `repository_id` string, nullable: Narrow to one repository.
- `user_id` string, nullable: Narrow to one developer: the owner of the connection.
- `client` string[], nullable: Repeatable. Canonical client label, e.g. 'Cursor'.

## Response `200`

Successful Response

- LiveTeamResponse: `GET /live/team` — functional §7.3. Self-only rule applied server-side.
  - `connected` integer, required: Members with an MCP connection or a check in 90 days
  - `not_connected` integer, required: Members with no MCP connection and no check ever
  - `showing_all` boolean, required: False when the caller only sees their own rows (team view off, not admin)
  - `rows` TeamRowResponse[], required
    - `user_id` string, required
    - `username` string, nullable: Display login; null when not cached
    - `client` string, nullable: Client label; null on idle and not-connected rows
    - `agents` string[]: Distinct models the client reported on this row's calls in the period
    - `checks` integer, nullable: Null on a not-connected row
    - `files_checked` integer, nullable
    - `issues_found` integer, nullable
    - `fixes_reported` integer, nullable
    - `last_check_at` string, date-time, nullable: Latest check of this row, unbounded by the period
    - `status` 'active' | 'idle' | 'not_connected', required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error

---

[API](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api.md) · [All operations](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/revisions/250c849925af?raw)