Update Employee Band API
Overview
Updates an existing Employee Band's name, auto-approval limit, max booking limit, or active status.
- Endpoint:
/api/bands/update - Method:
POST - Access: Corporate Admin / Admin
Request Body Schema
| Field | Type | Required | Description |
|---|---|---|---|
id | String (UUID) | Yes | Target Employee Band ID |
name | String | No | Updated band name |
code | String | No | Updated band code |
description | String | No | Updated description |
autoApprovalLimit | Number | No | Updated auto-approval limit |
maxBookingLimit | Number | No | Updated max booking limit |
active | Boolean | No | Enable/disable active status |
Request Body Example
{
"id": "b1234567-89ab-cdef-0123-456789abcdef",
"autoApprovalLimit": 10000,
"maxBookingLimit": 30000
}
Success Response (200 OK)
{
"success": true,
"message": "Employee Band updated successfully",
"data": {
"id": "b1234567-89ab-cdef-0123-456789abcdef",
"companyId": "c478a846-993d-4c8d-bf8d-d77cb3370e01",
"name": "Band 1",
"code": "B1",
"description": "Junior Executive Level Band",
"autoApprovalLimit": "10000.00",
"maxBookingLimit": "30000.00",
"active": true,
"createdAt": "2026-08-24T12:00:00.000Z",
"updatedAt": "2026-08-24T12:30:00.000Z",
"_count": {
"users": 1
}
}
}
Database Impact
- Table:
employee_bands(EmployeeBandmodel) - Operations:
UPDATErecord by ID.