# Staff leave & student absences

Keep staff leave requests and student absence reports in their respective review workflows.

Category: People
Guide: https://avkul.in/docs/guides/module-leave/
Guided sample demo: https://avkul.in/docs/demo/module-leave/
Snapshot: 11 October 2026

## Features

- Self-service staff leave
- Pending review
- Approve or reject
- Student absence report
- Approval and cancellation

## Access and 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.

Permission keys: hr:view, hr:update, attendance:view, attendance:manage

## Workflow

1. Choose staff leave or student absence reporting.
2. Enter the applicable dates and reason.
3. Submit or review through the permitted role.
4. Check the final decision and attendance impact.

## Fields and controls

- leaveType (string, optional)
- fromDate (string, declared required)
- toDate (string, optional)
- reason (string, optional)
- status ('APPROVED' | 'REJECTED', declared required)
- autoAssignCover (boolean, optional)
- remark (string, optional)
- studentId (string, declared required)
- attachmentUrl (string, optional)
- approve (boolean, declared required)

## Current limits

- Staff and student approval rules differ. The family view resolves linked-child ownership.

## Actual application access

- https://avkul.in/en/school/staff-leave
- https://avkul.in/en/school/student-leave

## API reference

- POST /api/v1/leave/apply — Self-service: apply for leave (resolves the caller's own staff profile); Authenticated scope
- GET /api/v1/leave/mine — Self-service: my own leave history; Authenticated scope
- GET /api/v1/leave/pending — Admin: pending leave requests awaiting a decision; hr:view
- PATCH /api/v1/leave/:id/decision — Admin: approve or reject a leave request; hr:update
- POST /api/v1/student-leave — Report a planned or past absence for a student; Authenticated scope
- GET /api/v1/student-leave/mine — Absences reported for my own children; Authenticated scope
- GET /api/v1/student-leave — List; attendance:view
- PATCH /api/v1/student-leave/:id/decision — Approve an absence, marking those days excused; attendance:manage
- PATCH /api/v1/student-leave/:id/cancel — Cancel; Authenticated scope

## Demo access

No login is required for the guided sample demo. Its fictional records and actions stay in this browser tab; they do not modify ERP records or send messages/payments. An assigned account is required for the actual ERP links.

Source inventory checked on 11 October 2026. This source inventory is not a certification of every external provider or device flow.