Delete Leave Type

curl -X DELETE https://api.companyflow.com/leave-types/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch(
  'https://api.companyflow.com/leave-types/a1b2c3d4-e5f6-7890-abcd-ef1234567890',
  {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const data = await response.json();

import requests

url = 'https://api.companyflow.com/leave-types/a1b2c3d4-e5f6-7890-abcd-ef1234567890'
headers = {
    'Authorization': 'Bearer YOUR_TOKEN'
}

response = requests.delete(url, headers=headers)
data = response.json()

{
  "success": true,
  "message": "leave type deleted"
}

{
  "success": false,
  "message": "invalid leave type id"
}

{
  "success": false,
  "message": "unauthorized"
}

{
  "success": false,
  "message": "internal server error"
}

DELETE

leave-types

{id}

curl -X DELETE https://api.companyflow.com/leave-types/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch(
  'https://api.companyflow.com/leave-types/a1b2c3d4-e5f6-7890-abcd-ef1234567890',
  {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const data = await response.json();

import requests

url = 'https://api.companyflow.com/leave-types/a1b2c3d4-e5f6-7890-abcd-ef1234567890'
headers = {
    'Authorization': 'Bearer YOUR_TOKEN'
}

response = requests.delete(url, headers=headers)
data = response.json()

{
  "success": true,
  "message": "leave type deleted"
}

{
  "success": false,
  "message": "invalid leave type id"
}

{
  "success": false,
  "message": "unauthorized"
}

{
  "success": false,
  "message": "internal server error"
}

Permanently delete a leave type. This operation removes the leave type configuration from the system.

This is a destructive operation. Ensure that no active leave balances or pending requests depend on this leave type before deletion.

Authentication

Requires authentication with Bearer token. Available to:

Super Admin
HR Manager

Path Parameters

string

required

The unique identifier of the leave type (UUID format)Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Response

boolean

Indicates if the request was successful

string

Confirmation message

curl -X DELETE https://api.companyflow.com/leave-types/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch(
  'https://api.companyflow.com/leave-types/a1b2c3d4-e5f6-7890-abcd-ef1234567890',
  {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const data = await response.json();

import requests

url = 'https://api.companyflow.com/leave-types/a1b2c3d4-e5f6-7890-abcd-ef1234567890'
headers = {
    'Authorization': 'Bearer YOUR_TOKEN'
}

response = requests.delete(url, headers=headers)
data = response.json()

{
  "success": true,
  "message": "leave type deleted"
}

{
  "success": false,
  "message": "invalid leave type id"
}

{
  "success": false,
  "message": "unauthorized"
}

{
  "success": false,
  "message": "internal server error"
}

Important Considerations

Before deleting a leave type, consider the following:

Active balances: Employees may have leave balances associated with this type
Pending requests: There may be pending leave requests using this type
Historical data: Approved leave history will be affected
Reporting: Reports may be incomplete if historical leave types are removed

Alternative: Deactivate Instead

Instead of deleting, consider setting the leave type status to inactive using the Update Leave Type endpoint. This preserves historical data while preventing new leave requests.

{
  "status": "inactive"
}

Create Leave Type - Create a new leave type
Update Leave Type - Modify or deactivate a leave type
List Leave Types - View all leave types

Authentication

Companies

Employees

Departments

Designations

Levels

Roles & Permissions

Leave Types

Leave Requests

Leave Balances

Memos

Approvals

Authentication

Path Parameters

Response

Important Considerations

Alternative: Deactivate Instead

​Authentication

​Path Parameters

​Response

​Important Considerations

​Alternative: Deactivate Instead

​Related Endpoints

Authentication

Path Parameters

Response

Important Considerations

Alternative: Deactivate Instead

Related Endpoints