Skip to main content

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

FieldTypeRequiredDescription
idString (UUID)YesTarget Employee Band ID
nameStringNoUpdated band name
codeStringNoUpdated band code
descriptionStringNoUpdated description
autoApprovalLimitNumberNoUpdated auto-approval limit
maxBookingLimitNumberNoUpdated max booking limit
activeBooleanNoEnable/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 (EmployeeBand model)
  • Operations: UPDATE record by ID.