Update Department API

Overview

Updates an existing department's name, budget, or cost code.

• Endpoint: /api/departments/update
• Method: POST
• Access: Corporate Admin

Request Body Schema

Field	Type	Required	Description
id	String (UUID)	Yes	Target department ID
name	String	No	Updated department name
budget	Number	No	Updated budget
costCode	String	No	Updated cost code

Request Body Example

{
  "id": "d1234567-89ab-cdef-0123-456789abcdef",
  "budget": 750000.00
}

Success Response (200 OK)

{
  "success": true,
  "message": "Department updated successfully",
  "data": {
    "id": "d1234567-89ab-cdef-0123-456789abcdef",
    "name": "Marketing",
    "budget": "750000.00",
    "costCode": "MKT-01"
  }
}

Database Impact

• Table: departments
• Operations: UPDATE record by ID.