# Staff directory & lifecycle

Use staff directory & lifecycle in the school workspace. Maintain staff profiles, inspect connected responsibilities and record departure or reinstatement.

Category: People
Guide: https://avkul.in/docs/guides/screen-school-staff/
Guided sample demo: https://avkul.in/docs/demo/screen-school-staff/
Snapshot: 11 October 2026

## Features

- Offboard
- Reinstate
- Download Template
- Export to Excel
- List
- List Former
- Add a staff member
- What still depends on this person
- Mark a staff member as having left

## Access and setup

Intended access: Assigned account with the required permissions
- A school account with the permissions shown below.
- Choose the relevant school, academic session or child before working.

Permission keys: hr:view, hr:create, hr:manage

## Workflow

1. Find or create the staff profile.
2. Review employment details and linked responsibilities.
3. Inspect clearance before offboarding.
4. Use reinstatement when returning a former staff member.

## Fields and controls

- employeeCode (string, declared required)
- firstName (string, declared required)
- lastName (string, optional)
- gender (string, optional)
- dateOfBirth (string, optional)
- email (string, optional)
- phone (string, optional)
- branchId (string, optional)
- departmentId (string, optional)
- designationId (string, optional)
- reportsToId (string, optional)
- joiningDate (string, optional)
- contractType (string, optional)
- qualifications (unknown, optional)
- exitStatus ('RESIGNED' | 'TERMINATED' | 'RETIRED', optional)
- exitDate (string, optional)
- reason (string, optional)
- force (boolean, optional)

## Current limits

- Offboarding is separate from deleting historical school activity. Permission and dependency checks govern each action.

## Actual application access

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

## API reference

- GET /api/v1/staff — List; hr:view
- GET /api/v1/staff/former — List Former; hr:view
- POST /api/v1/staff — Add a staff member; hr:create
- GET /api/v1/staff/:id/clearance — What still depends on this person; hr:view
- POST /api/v1/staff/:id/offboard — Mark a staff member as having left; hr:manage
- POST /api/v1/staff/:id/reinstate — Reinstate; hr:manage

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