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
200
Holiday day deleted successfully
401
Unauthorized - Invalid or missing authentication token
403
Forbidden - Insufficient API scopes or permissions