Delete Department API

Overview

Deletes a department if no users are currently assigned to it.

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

Request Body Schema

Field	Type	Required	Description
id	String (UUID)	Yes	Target department ID

Request Body Example

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

Success Response (200 OK)

{
  "success": true,
  "message": "Department deleted successfully",
  "data": {
    "id": "d1234567-89ab-cdef-0123-456789abcdef",
    "name": "Marketing"
  }
}

Error Response (400 Bad Request)

{
  "success": false,
  "message": "Cannot delete Department 'Marketing' because it has 15 assigned user(s)",
  "data": null
}

Database Impact

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