This document provides an overview of the key API endpoints available in the CampusVersa backend.
All protected routes require a Bearer Token in the Authorization header.
Header: Authorization: Bearer <token>
- Endpoint:
/student/register - Method:
POST - Description: Registers an independent student. Captures referral source via
utm_source.
- Endpoint:
/student/login - Method:
POST - Description: Authenticates a student and returns a JWT token.
- Endpoint:
/student/me - Method:
GET - Description: Returns the logged-in student's profile data.
- Endpoint:
/student/update-profile - Method:
POST - Description: Updates student metadata including preferred language and academic info.
- Endpoint:
/faculty/login - Method:
POST - Description: Authenticates a faculty member.
- Endpoint:
/faculty/my-courses - Method:
GET - Description: Returns courses assigned to the logged-in faculty.
- Endpoint:
/faculty/evaluation/bulk-update - Method:
POST - Description: Bulk updates marks or attendance for a specific course.
- Endpoint:
/institute/register - Method:
POST - Description: Submits a request for an institute to be onboarded. Captures referral source.
- Endpoint:
/institute/login - Method:
POST - Description: Authenticates an institute administrator or authorized faculty member.
- Endpoint:
/api/ai/generate - Method:
POST - Description: Proxies requests to configured LLM providers (Gemini/OpenAI). Supports system instructions and custom prompts.
- Endpoint:
/student/performance/analyze - Method:
POST - Description: Uses AI to analyze a student's academic profile and provide improvement insights.
- Endpoint:
/api/student-jobs/search - Method:
POST - Description: Searches for jobs and freelance opportunities based on student skills using the Adzuna API.
Back to README.md