Activity Summary Aggregator

List aggregated activity summaries across all mentors

{
  "data": [
    {
      "mentor_id": "mentor_001",
      "total_sessions": 25,
      "average_session_duration_minutes": 30,
      "total_minutes": 750,
      "last_session_date": "2026-03-18T15:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}

Get full aggregated activity summary for a specific mentor

{
  "mentor_id": "mentor_001",
  "total_sessions": 25,
  "average_session_duration_minutes": 30,
  "total_minutes": 750,
  "last_session_date": "2026-03-18T15:00:00Z"
}

Create or seed an activity summary record for a mentor

{
  "mentor_id": "mentor_002",
  "total_sessions": 10,
  "average_session_duration_minutes": 45,
  "total_minutes": 450,
  "last_session_date": "2026-03-10T10:00:00Z"
}

{
  "mentor_id": "mentor_002",
  "total_sessions": 10,
  "average_session_duration_minutes": 45,
  "total_minutes": 450,
  "last_session_date": "2026-03-10T10:00:00Z"
}

Trigger re-aggregation / update the cached summary for a mentor

{
  "force_refresh": true
}

{
  "mentor_id": "mentor_001",
  "total_sessions": 28,
  "average_session_duration_minutes": 31,
  "total_minutes": 868,
  "last_session_date": "2026-03-25T16:30:00Z"
}

Remove cached activity summary for a mentor (forces fresh aggregation on next request)

{
  "deleted": true,
  "mentor_id": "mentor_001"
}

Get total session count for a mentor

{
  "mentor_id": "mentor_001",
  "total_sessions": 25
}

Get average session duration in minutes for a mentor

{
  "mentor_id": "mentor_001",
  "average_session_duration_minutes": 30
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}