---
search:
  tags:
    - holidays
    - DELETE
seo:
  description: >-
    Note: This endpoint is not implemented. To reset a custom holiday… Reference
    for the DELETE /holidays/years/{yearId} endpoint in the Leadtime Public API
    API.
sidebar:
  badge: DELETE
  label: Delete custom holiday year
title: Delete custom holiday year
type: openapi-operation
---
**Note:** This endpoint is not implemented. To reset a custom holiday year back to defaults, use `POST /holidays/years` instead.

**How to reset a year:**
To delete a custom holiday year and return to default holidays:
1. Call `POST /holidays/years` with the same `year` and `country` values
2. This will delete the existing custom year and recreate it with default holidays
3. All custom holidays for that year will be removed

**Why this approach?**
The holiday service uses a "recreate" pattern where creating a custom year automatically deletes any existing custom year for the same year/country combination. This ensures a clean reset to defaults while maintaining data consistency.

<Operation source="api-reference" id="holidayscontroller-deleteholidayyear" />