Delete department

Updated date: 01/10/2026
Updated by: VNPT eContract's team

---

Purpose

The function deletes one or multiple departments by department code.

• Request URL: /api/departments/bulk-delete
• HTTP method: DELETE
• HTTP content-type: application/json
• Authorize: Bearer token
• Parameter:

Key	Type	Required	Description
codes	Array[string]	Yes	Codes of the departments to delete.

caution

A department that still has assigned users cannot be deleted. Remove its users before deleting the department.

Sample request

{
    "codes": ["HR"]
}

Sample successful response body

{
    "data": [
        {
            "id": 12012,
            "name": "Human Resources",
            "code": "HR",
            "userCount": 0,
            "sharingAccessPermission": false,
            "users": [],
            "requireApproval": false
        }
    ],
    "success": true,
    "code": 0,
    "messages": [
        "Deleted 1 departments successfully"
    ]
}

Sample failed response bodies

The department still has assigned users:

{
    "success": false,
    "code": 0,
    "messages": [
        "Can not delete department had user, department codes: IT"
    ]
}

The department code does not exist:

{
    "success": false,
    "code": 0,
    "messages": [
        "Department not found, department codes: UNKNOWN"
    ]
}

Response Body Description

Key	Type	Description
success	boolean	Response status (true: Success, false: Failure).
code	int	Response code from the system.
messages	array	List of deletion result or error messages.
data	array	List of deleted departments. This field is omitted when the request fails.