Skip to main content

Approval Workflows

Request approval system for leave, equipment, expenses, and custom workflows.

Overview​

The approval system provides multi-level request handling with configurable policies and team-based approvals.

Approval Flow​

Employee submits request
│
├── Auto-approved? → ✅ Done
│
└── Manual review
├── Team lead approves
├── Manager approves
└── ✅ Request approved / ❌ Rejected

Core Entities​

Approval Policy​

FieldTypeDescription
namestringPolicy name
descriptionstringPolicy details
approvalTypeenumTime Off, Equipment, Expense, Custom

Request Approval​

FieldTypeDescription
namestringRequest title
typestringRequest type
statusenumPending, Approved, Refused
min_countnumberMinimum approvals needed
approvalPolicyIdUUIDAssociated policy
employeeApprovalsEmployee[]Required employee approvers
teamApprovalsTeam[]Required team approvers

Approval Types​

TypeUse Case
Time OffLeave/vacation requests
EquipmentEquipment sharing requests
ExpenseExpense report approvals
CustomAny custom approval workflow

API Endpoints​

# Approval Policies
GET /api/approval-policy
POST /api/approval-policy
PUT /api/approval-policy/:id

# Request Approvals
GET /api/request-approval
POST /api/request-approval
PUT /api/request-approval/:id

# Approve/Refuse
PUT /api/request-approval/:id/approve
PUT /api/request-approval/:id/refuse