---
title: "Update a holiday"
method: PUT
path: "/v1/workspaces/{workspaceId}/holidays/{holidayId}"
tags: ["Holiday"]
---

# Update a holiday

`PUT /v1/workspaces/{workspaceId}/holidays/{holidayId}`

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.
- `holidayId` string, required — Represents a holiday identifier across the system.

## Request body

- UpdateHolidayRequestV1
  - `automaticTimeEntryCreation` AutomaticTimeEntryCreationRequest — Provides automatic time entry creation settings.
    - `defaultEntities` DefaultEntitiesRequest, required — Provides information about default project and task for automatically created time entries.
      - `projectId` string — Default project for automatically created time entries
      - `taskId` string — Default task for automatically created time entries
    - `enabled` boolean — Indicates that automatic time entry creation is enabled.
  - `color` string — Provide color in format ^#(?:[0-9a-fA-F]{6}){1}$. Explanation: A valid color code should start with '#' and consist of six hexadecimal characters, representing a color in hexadecimal format. Color value is in standard RGB hexadecimal format.
  - `datePeriod` DatePeriodRequest, required — Provide startDate and endDate for the holiday.
    - `endDate` string, required — yyyy-MM-dd format date
    - `startDate` string, required — yyyy-MM-dd format date
  - `everyoneIncludingNew` boolean — Indicates whether the holiday is shown to new users.
  - `name` string, required — Provide the name you would like to use for updating the holiday.
  - `occursAnnually` boolean, required — Indicates whether the holiday occurs annually.
  - `userGroups` ContainsUserGroupFilterRequest — Provide list with user group ids and corresponding status.
    - `contains` 'CONTAINS' | 'DOES_NOT_CONTAIN' | 'CONTAINS_ONLY' — Filter type.
    - `ids` string[] — Represents a list of filter identifiers.
    - `status` 'PENDING' | 'ACTIVE' | 'DECLINED' | 'INACTIVE' | 'ALL' — Filters entities by status.
  - `users` ContainsUsersFilterRequestForHoliday — Provide list with users ids and corresponding status.
    - `contains` 'CONTAINS' | 'DOES_NOT_CONTAIN' | 'CONTAINS_ONLY' — Filter type.
    - `ids` string[] — Represents a list of filter identifiers.
    - `status` 'ALL' | 'ACTIVE' | 'INACTIVE' — Filters entities by status.
    - `statuses` string[]

## Response `200`

OK

- HolidayDtoV1
  - `automaticTimeEntryCreation` boolean — Indicates that time entries will be automatically created for this holiday.
  - `datePeriod` DatePeriod — Represents startDate and endDate of the holiday. Date is in format yyyy-mm-dd
    - `endDate` string, date
    - `startDate` string, date
  - `everyoneIncludingNew` boolean — Indicates whether the holiday is shown to new users.
  - `id` string — Represents holiday identifier across the system.
  - `name` string — Represents the name of the holiday.
  - `occursAnnually` boolean — Indicates whether the holiday occurs annually.
  - `projectId` string — Represents projectId for automatic time entry creation.
  - `taskId` string — Represents taskId for automatic time entry creation.
  - `userGroupIds` string[] — Indicates which user groups are included.
  - `userIds` string[] — Indicates which users are included.
  - `workspaceId` string — Represents workspace identifier across the system.

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)