AVKUL ERPDocs
MODULE GUIDE · 11 OCT 2026

College administration

Manage department and semester structures, electives, internal marks, placements and research records.

Try guided demo →Download guide ↓
College administration — illustrated workflow banner
OVERVIEW

What you can do

01

Departments

02

Semesters

03

Electives and enrollment

04

Internal marks

05

Placements

06

Research projects

BEFORE YOU BEGIN

Access & setup

Intended access: Assigned account with the required permissions.

  • An assigned school account with the required permissions.
  • The academic, student or staff setup used by this workflow.
Required permission keys
student:viewstudent:createstudent:updatestudent:delete

Use the public sample demo to learn this flow. Your assigned ERP account determines access to actual school records.

STEP BY STEP

How the workflow works

  1. 01

    Create the department and semester structure

    An assigned school account with the required permissions.

  2. 02

    Offer electives with the required limits

    Semesters is part of the documented workflow.

  3. 03

    Record eligible enrollments and internal marks

    Electives and enrollment is part of the documented workflow.

  4. 04

    Maintain placement and research records

    Review the result in the connected record or workspace before moving on.

Request fields to understand

Source-declared fields used by related operations; each operation has its own validation and scope.

FieldDeclared typeInput
namestringOptional
codestringRequired by declaration
hodStaffIdstringOptional
descriptionstringOptional
totalSeatsnumberOptional
departmentIdstringRequired by declaration
semesterNonumberRequired by declaration
typeSemesterTypeRequired by declaration
startDatestringOptional
endDatestringOptional
totalCreditsnumberOptional
isActivebooleanOptional
subjectIdstringRequired by declaration
semesterIdstringRequired by declaration
maxStudentsnumberOptional
creditsnumberOptional
teacherStaffIdstringOptional
statusstringOptional
electiveIdstringRequired by declaration
studentIdstringRequired by declaration
assignment1numberOptional
assignment2numberOptional
midSemnumberOptional
attendancenumberOptional
CURRENT BEHAVIOUR

Rules & current limits

  • College workflows share the school account and permission context; college-specific setup must exist.

Source inventory checked on 11 October 2026. Guide availability confirms documentation publication, not certification of every external service or device flow.

LEARN BY DOING

Try college administration

Open a guided sample workspace, try the available actions, then reset whenever you like. No login required.

Launch guided demo →
FOR IMPLEMENTERS

API & permissions reference

This is the module’s source-declared endpoint catalogue. Reading this reference does not execute any request.

21 source-declared operations
GET/api/v1/college/stats

College overview stats

student:view
GET/api/v1/college/departments

List all departments

student:view
POST/api/v1/college/departments

Create a department

student:create

Declared request fields: name (required), code (required), hodStaffId (optional), description (optional), totalSeats (optional).

PATCH/api/v1/college/departments/:id

Update a department

student:update

Declared request fields: name (optional), hodStaffId (optional), description (optional), totalSeats (optional).

DELETE/api/v1/college/departments/:id

Delete a department

student:delete
GET/api/v1/college/semesters

List semesters (filter by departmentId)

student:view
POST/api/v1/college/semesters

Create a semester

student:create

Declared request fields: name (required), departmentId (required), semesterNo (required), type (required), startDate (required), endDate (required), totalCredits (optional).

PATCH/api/v1/college/semesters/:id

Update a semester

student:update

Declared request fields: name (optional), startDate (optional), endDate (optional), totalCredits (optional), isActive (optional).

GET/api/v1/college/electives

List elective subjects (filter by semesterId)

student:view
POST/api/v1/college/electives

Create an elective subject offering

student:create

Declared request fields: subjectId (required), semesterId (required), maxStudents (optional), credits (optional), teacherStaffId (optional).

PATCH/api/v1/college/electives/:id

Update elective (status, max students)

student:update

Declared request fields: maxStudents (optional), status (optional), teacherStaffId (optional).

POST/api/v1/college/electives/enroll

Enroll a student in an elective

student:create

Declared request fields: electiveId (required), studentId (required).

GET/api/v1/college/internal-marks

List internal marks (filter by semesterId, studentId)

student:view
POST/api/v1/college/internal-marks

Create internal marks entry

student:create

Declared request fields: studentId (required), subjectId (required), semesterId (required), assignment1 (optional), assignment2 (optional), midSem (optional), attendance (optional), practical (optional), maxMarks (optional).

PATCH/api/v1/college/internal-marks/:id

Update internal marks

student:update

Declared request fields: assignment1 (optional), assignment2 (optional), midSem (optional), attendance (optional), practical (optional).

GET/api/v1/college/placements

List placement records (filter by status)

student:view
POST/api/v1/college/placements

Create a placement record

student:create

Declared request fields: studentId (required), companyName (required), role (optional), ctcLpa (optional), appliedAt (optional), notes (optional).

PATCH/api/v1/college/placements/:id

Update placement status

student:update

Declared request fields: status (optional), ctcLpa (optional), offerDate (optional), notes (optional).

GET/api/v1/college/research

List research projects (filter by departmentId)

student:view
POST/api/v1/college/research

Create a research project

student:create

Declared request fields: title (required), departmentId (required), piStaffId (optional), description (optional), fundingAmount (optional), fundingSource (optional), startDate (optional), endDate (optional), coInvestigatorIds (optional).

PATCH/api/v1/college/research/:id

Update a research project

student:update

Declared request fields: title (optional), description (optional), fundingAmount (optional), status (optional), endDate (optional).

Open the actual application

ERP links use your assigned account. Record-specific pages start from the list so you can choose a real record.

/en/school/collegeOpen ↗

Keep exploring

Screen guideCollege administration →