Delete Employee

Delete an employee (soft delete by default, or hard delete with query parameter)

DELETE /employees/{id}

Soft Delete

curl -X DELETE https://api.companyflow.com/employees/emp-uuid-here \
  -H "Authorization: Bearer YOUR_TOKEN"

200 Success

{
  "success": true,
  "message": "employee deleted"
}

Authentication

This endpoint requires Bearer token authentication with one of the following roles:

• super_admin
• hr_manager

Path Parameters

id · string · required

The unique identifier of the employee (UUID format)

Query Parameters

hard_delete · boolean · default: "false"

If set to true, permanently deletes the employee. Otherwise performs a soft delete.

Response

success · boolean

Indicates if the request was successful

message · string

Confirmation message

Soft Delete

curl -X DELETE https://api.companyflow.com/employees/emp-uuid-here \
  -H "Authorization: Bearer YOUR_TOKEN"

200 Success

{
  "success": true,
  "message": "employee deleted"
}