📋 API Status Overview

Manager role APIs are currently partially implemented. Many endpoints are shared with Admin/Analytics APIs but scoped to team members. This page documents existing, planned, and recommended APIs for the Manager role.

✓ Existing ⚠ Planned ✗ Missing 💡 Recommended

✅ Existing Manager APIs

These APIs currently support Manager role access (via [Authorize(Roles="SuperAdmin,Admin,Manager")] or permission-based):

Team User Listing
GET /api/usersmanagement

List users in organization. Managers see team members based on hierarchy.

Existing Permission-based

Organization Analytics
GET /api/analytics/organization/{id}

View analytics for organization (manager's own org).

Existing Plan feature gated

Export Jobs
POST /api/export-jobs

Create background export jobs for team reports.

Existing SuperAdmin+Admin+Manager

⚠️ Planned Manager APIs

These APIs are planned for implementation but not yet available:

Manager Team Dashboard
GET /api/manager/dashboard

Manager-specific dashboard with team rollup metrics.

Planned Q3 2026

Direct Reports API
GET /api/manager/direct-reports

List users who report to the manager (requires hierarchy feature).

Planned Depends on org chart

Team Productivity Metrics
GET /api/manager/productivity

Aggregated productivity metrics for the manager's team.

Planned Backend service needed

These APIs are recommended for complete Manager functionality:

Team Comparison Report
GET /api/manager/team-comparison

Compare productivity and AI usage across team members.

Recommended

Team Goals & Targets
GET /api/manager/goals

View and manage productivity goals for team members.

Recommended

AI Tool Adoption by Team
GET /api/manager/tool-adoption

Track which AI tools team members are adopting.

Recommended

Team Audit Trail
GET /api/manager/audit-trail

View audit logs filtered to team members only.

Recommended

🎯 Manager Role Capability Matrix

CapabilityCurrent StatusAPIsPriority
View Team Members✓ Partial/api/usersmanagementHigh
Team Analytics⚠ Limited/api/analytics/organization/{id}High
Team Reports✓ Available/api/export-jobsMedium
Direct Reports✗ MissingNeeds org hierarchyMedium
Productivity Tracking✗ MissingNew service neededMedium
Team Goals✗ MissingNew featureLow
AI Adoption Insights💡 RecommendedAnalytics extensionLow

🏗️ Implementation Roadmap

Manager API Implementation Roadmap ═══════════════════════════════════════════════════════════════════════════════ Phase 1 (Current - Q2 2026): ├── ✓ Reuse Admin APIs with Manager role access ├── ✓ Permission-based user listing ├── ✓ Export job creation └── ⚠ Limited team-specific filtering Phase 2 (Q3 2026): ├── ⚠ ManagerDashboardController ├── ⚠ /api/manager/dashboard endpoint ├── ⚠ Team hierarchy service ├── ⚠ Direct reports API └── ⚠ Manager-specific DTOs Phase 3 (Q4 2026): ├── 💡 Team productivity service ├── 💡 Manager analytics aggregation ├── 💡 Team comparison reports └── 💡 Manager notification service Phase 4 (Future): ├── 💡 AI adoption tracking ├── 💡 Team goals & OKRs ├── 💡 Performance benchmarking └── 💡 Predictive analytics Dependencies: ├── Organization hierarchy (Org Chart feature) ├── Enhanced permission system ├── Manager-specific subscription tier └── Frontend Manager module