---
title: "Create operator holiday"
method: POST
path: "/api/operators/holidays"
tags: ["operators"]
---

# Create operator holiday

`POST /api/operators/holidays`

## Request body

- OperatorHolidayCreateRequest — Request body to create an operator holiday period.
  - `operator_id` string, uuid, required — Operator UUID
  - `start_date` string, date-time, required — Start date and time of the holiday period (inclusive)
  - `end_date` string, date-time, required — End date and time of the holiday period (inclusive)

## Response `201`

Successful Response

- OperatorHolidayResponse — Response model for operator holiday information.
  - `id` string, uuid, required — Holiday UUID
  - `operator_id` string, uuid, required — Operator UUID
  - `start_date` string, date-time, required — Start date and time of the holiday period (inclusive)
  - `end_date` string, date-time, required — End date and time of the holiday period (inclusive)
  - `created_at` string, date-time, required — Creation timestamp
  - `updated_at` string, date-time, nullable — Last update timestamp
  - `message` string, nullable — Human-readable alert sync outcome
  - `operator_alert_action` string, nullable — Alert sync action: closed, created, or promoted
  - `operator_alert_closed` boolean — True when the holiday change closed the alert
  - `invalidate_all` boolean — True when the frontend must invalidate all local route data
  - `site_restricted` boolean — True when the frontend must switch to restricted site mode
  - `operator_alert_sync` AvailabilityOperatorAlertSyncResponse
    - `action` string, nullable — Alert sync action: closed, created, or promoted
    - `alert_id` string, nullable — Operator alert UUID affected by the availability change
    - `alert_type` string, nullable — Operator alert type affected by the availability change
    - `closed` boolean — True when the availability change closed the alert
    - `invalidate_all` boolean — True when the frontend must invalidate all local route data
    - `site_restricted` boolean — True when the frontend must switch to restricted site mode
    - `message` string, nullable — Human-readable alert sync outcome

## Other responses

- `422` — Validation Error

---

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