Create Holiday List

openapi: 3.1.0
info:
  title: Create Holiday List
  version: 1.0.0

paths:
  /api/holiday-lists:
    post:
      summary: Create a Holiday List
      description: Creates a new Holiday List for the authenticated workspace.
      tags:
        - Holiday Lists

      security:
        - bearerAuth: []

      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
                - holidays
              properties:
                name:
                  type: string
                  example: India Public Holidays
                description:
                  type: string
                  example: National holidays observed across India.
                holidays:
                  type: array
                  description: List of holidays to include.
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                        example: Republic Day
                      date:
                        type: string
                        format: date
                        example: "2026-01-26"

      responses:
        "201":
          description: Holiday List created successfully.

        "400":
          description: Invalid request.

        "401":
          description: Unauthorized.

        "500":
          description: Internal Server Error.

components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

curl --location '{{baseUrl}}/api/holiday-lists' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "name": "India Public Holidays",
  "description": "National holidays observed across India.",
  "holidays": [
    {
      "name": "Republic Day",
      "date": "2026-01-26"
    },
    {
      "name": "Independence Day",
      "date": "2026-08-15"
    }
  ]
}'

{
  "success": true,
  "message": "Holiday List created successfully.",
  "data": {
    "_id": "6863f5ab1e4d7f0012345678",
    "name": "India Public Holidays",
    "description": "National holidays observed across India.",
    "enabled": true,
    "holidayCount": 2,
    "createdAt": "2026-07-21T10:30:15.000Z",
    "updatedAt": "2026-07-21T10:30:15.000Z"
  }
}

{
  "success": false,
  "message": "Invalid request payload."
}

{
  "success": false,
  "message": "Unauthorized"
}

{
  "success": false,
  "message": "Failed to create Holiday List."
}