Delete holiday day
Deletes a holiday day from a custom holiday year configuration.
What this does: Removes a holiday from the custom year configuration. The holiday is soft-deleted, meaning it’s marked as deleted but not permanently removed from the database.
Important:
- Only holidays in custom years can be deleted
- You cannot delete holidays from default years - create a custom year first
- This is useful for removing holidays that don’t apply to your organization
- The holiday will no longer appear in holiday lists or affect capacity calculations
Use cases:
- Removing regional holidays that don’t apply to your organization
- Removing religious holidays that aren’t observed by your company
- Cleaning up holidays you previously added but no longer need
Note: If you want to restore a deleted holiday, you can either:
- Recreate the custom year using
POST /holidays/years(resets to defaults) - Add the holiday back using
POST /holidays/days
DELETE
/holidays/days/{dayId}Authorization
AuthorizationOAuth2 access token · headerrequiredScopes:
api:writeor
AuthorizationBearer token (JWT) · headerrequiredPath parameters
dayIdstringrequiredResponses
200Holiday day deleted successfully
401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient API scopes or permissions
Request
curl -X DELETE "https://leadtime.app/api/public/holidays/days/string" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"const response = await fetch("https://leadtime.app/api/public/holidays/days/string", {
method: "DELETE",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});import requests
response = requests.delete(
"https://leadtime.app/api/public/holidays/days/string",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
)Response
Holiday day deleted successfully
Unauthorized - Invalid or missing authentication token
Forbidden - Insufficient API scopes or permissions