Mentor Activity Log Repository - API Contract

GET /api/v1/activity-logs/api/v1/activity-logs

List activity log entries with filtering

Public

Response Example

{
  "data": [
    {
      "log_id": "log_001aaa",
      "mentor_id": "mentor_a1b2c3",
      "activity_type": "session_completed",
      "description": "Conducted weekly check-in with assigned contact",
      "contact_id": "contact_xyz123",
      "occurred_at": "2026-03-20T14:00:00Z",
      "created_at": "2026-03-20T14:30:00Z"
    },
    {
      "log_id": "log_002bbb",
      "mentor_id": "mentor_a1b2c3",
      "activity_type": "referral_made",
      "description": "Referred contact to specialist support",
      "contact_id": "contact_xyz123",
      "occurred_at": "2026-03-18T10:00:00Z",
      "created_at": "2026-03-18T10:15:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 34
  }
}

GET /api/v1/activity-logs/api/v1/activity-logs/:id

Get a single activity log entry

Public

Response Example

{
  "log_id": "log_001aaa",
  "mentor_id": "mentor_a1b2c3",
  "activity_type": "session_completed",
  "description": "Conducted weekly check-in with assigned contact",
  "contact_id": "contact_xyz123",
  "duration_minutes": 45,
  "occurred_at": "2026-03-20T14:00:00Z",
  "created_at": "2026-03-20T14:30:00Z"
}

POST /api/v1/activity-logs/api/v1/activity-logs

Record a new mentor activity

Public

Request Example

{
  "mentor_id": "mentor_a1b2c3",
  "activity_type": "session_completed",
  "description": "Monthly progress review",
  "contact_id": "contact_xyz123",
  "duration_minutes": 60,
  "occurred_at": "2026-03-26T13:00:00Z"
}

Response Example

{
  "log_id": "log_003ccc",
  "mentor_id": "mentor_a1b2c3",
  "activity_type": "session_completed",
  "description": "Monthly progress review",
  "contact_id": "contact_xyz123",
  "duration_minutes": 60,
  "occurred_at": "2026-03-26T13:00:00Z",
  "created_at": "2026-03-26T13:05:00Z"
}

PUT /api/v1/activity-logs/api/v1/activity-logs/:id

Update an activity log entry

Public

Request Example

{
  "description": "Monthly progress review — updated notes added",
  "duration_minutes": 65
}

Response Example

{
  "log_id": "log_003ccc",
  "mentor_id": "mentor_a1b2c3",
  "description": "Monthly progress review — updated notes added",
  "duration_minutes": 65,
  "updated_at": "2026-03-26T14:00:00Z"
}

DELETE /api/v1/activity-logs/api/v1/activity-logs/:id

Delete an activity log entry

Public

Response Example

{
  "deleted": true,
  "log_id": "log_001aaa"
}

GET /api/v1/activity-logs/api/v1/activity-logs/mentor/:mentor_id/summary

Get aggregated activity summary for a mentor

Public

Response Example

{
  "mentor_id": "mentor_a1b2c3",
  "period": "month",
  "period_start": "2026-03-01T00:00:00Z",
  "period_end": "2026-03-31T23:59:59Z",
  "total_activities": 12,
  "total_sessions": 8,
  "total_referrals": 2,
  "total_check_ins": 2,
  "total_duration_minutes": 520,
  "unique_contacts_supported": 3
}

GET /api/v1/activity-logs/api/v1/activity-logs/mentor/:mentor_id/count-by-type

Get activity counts grouped by type for a mentor

Public

Response Example

{
  "mentor_id": "mentor_a1b2c3",
  "counts": {
    "session_completed": 42,
    "referral_made": 7,
    "check_in": 18,
    "documentation": 15,
    "training_attended": 4
  }
}

Additional Metadata

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