teams

Get Team Analytics

TEAM-003 W1-T1.1 — Owner analytics (absorbs IMPROVE-001 B3).

Read-only aggregates computed from EXISTING data:

  • per-member contribution (runs initiated, workspace agents registered, Team Scorecards published),
  • shared workspace-agent usage,
  • seat + monthly-run cap utilization,
  • provenance (real vs simulated) split on every run count + a 30-day runs/day series — simulated (mock) activity must never read as real performance (BRIEF-IMPROVE-002 §6/§10, mirrors the Talent Pool chips).

Gate: TeamPermission.VIEW_WORKSPACE_ANALYTICS (Owner + Admin). A member or viewer who lacks it gets 403; a non-member stays opaque with 404, matching the cross-tenant existence-hiding posture of require_team_permission. The client cannot self-authorize — this endpoint is the real gate.

Every query below is a plain COUNT(*) … GROUP BY on indexed columns, so the read runs identically on Postgres and the aiosqlite test path (CLAUDE.md rule #6). No cost is invented (no per-member cost, no LLM cost).

get/api/v1/teams/{team_id}/analytics

Request

  • Base URL: https://api.badgeia.com
  • URL: https://api.badgeia.com/api/v1/teams/{team_id}/analytics
  • Auth: none declared

Path parameters

team_idstring uuid required

Response

Successful Response

team_idstring uuid required
planstring required
seats_usedinteger required
max_seatsinteger required
monthly_run_countinteger required
monthly_run_capinteger nullable
total_runs_initiatedinteger required
total_workspace_agentsinteger required
total_scorecards_publishedinteger required
runs_window_daysinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.