Proxy Contact List Provider

List or search mentors available to a coordinator (searchMentors / watchCoordinatorMentors)

{
  "data": [
    {
      "id": "mentor-17",
      "full_name": "Alice Nguyen",
      "email": "alice.nguyen@school.edu",
      "area": "Mathematics",
      "status": "active",
      "last_activity_date": "2026-03-20"
    },
    {
      "id": "mentor-18",
      "full_name": "Ben Okafor",
      "email": "ben.okafor@school.edu",
      "area": "Science",
      "status": "active",
      "last_activity_date": "2026-03-18"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 14
  }
}

Get full mentor contact details by ID (getMentorById)

{
  "id": "mentor-17",
  "full_name": "Alice Nguyen",
  "email": "alice.nguyen@school.edu",
  "phone": "+353-87-1234567",
  "area": "Mathematics",
  "status": "active",
  "coordinator_id": "coord-42",
  "last_activity_date": "2026-03-20",
  "total_activities": 8
}

Add a mentor to a coordinator's contact list

{
  "coordinator_id": "coord-42",
  "mentor_id": "mentor-25",
  "notes": "New mentee assigned March 2026"
}

{
  "id": "contact-099",
  "coordinator_id": "coord-42",
  "mentor_id": "mentor-25",
  "added_at": "2026-03-26T09:00:00Z"
}

Refresh or update a mentor contact entry (refreshContacts)

{
  "action": "refresh",
  "coordinator_id": "coord-42"
}

{
  "id": "mentor-17",
  "full_name": "Alice Nguyen",
  "email": "alice.nguyen@school.edu",
  "area": "Mathematics",
  "status": "active",
  "refreshed_at": "2026-03-26T09:05:00Z"
}

Remove a mentor from a coordinator's contact list

{
  "message": "Mentor contact mentor-17 removed from coordinator coord-42 contact list"
}

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