Skip to content
Leadtime
English
Esc
navigateopen⌘Jpreview

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 · headerrequired
Scopes:api:write
or
AuthorizationBearer token (JWT) · headerrequired
Path parameters
dayIdstringrequired
Responses
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"
Response
Holiday day deleted successfully