> ## Documentation Index
> Fetch the complete documentation index at: https://docs.weya.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Holiday List

> Delete an existing Holiday List from your Weya AI workspace.

Use this endpoint to permanently delete a Holiday List. Once deleted, the Holiday List will no longer be available for campaign scheduling or future use.

<Warning>
  Deleting a Holiday List is permanent and cannot be undone. Ensure that the Holiday List is no longer being used by any active campaigns before deleting it.
</Warning>

### OpenAPI

```yaml theme={null}
openapi: 3.1.0
info:
  title: Delete Holiday List
  version: 1.0.0

paths:
  /api/holiday-lists/{id}:
    delete:
      summary: Delete a Holiday List
      description: Permanently deletes an existing Holiday List.
      tags:
        - Holiday Lists

      security:
        - bearerAuth: []

      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
          description: Unique identifier of the Holiday List.

      responses:
        "200":
          description: Holiday List deleted successfully.

        "401":
          description: Unauthorized.

        "404":
          description: Holiday List not found.

        "409":
          description: Holiday List is currently in use.

        "500":
          description: Internal Server Error.

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

## Authorizations

<ParamField header="Authorization" type="string" required>
  Bearer Token for the authenticated user.

  Format:

  `Authorization: Bearer YOUR_ACCESS_TOKEN`
</ParamField>

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the Holiday List to delete.
</ParamField>

## Example Request

```bash theme={null}
curl --location --request DELETE '{{baseUrl}}/api/holiday-lists/6863f5ab1e4d7f0012345678' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

## Successful Response

```json theme={null}
{
  "success": true,
  "message": "Holiday List deleted successfully."
}
```

## Response Fields

<ResponseField name="success" type="boolean">
  Indicates whether the Holiday List was successfully deleted.
</ResponseField>

<ResponseField name="message" type="string">
  Confirmation message indicating the Holiday List has been removed.
</ResponseField>

## Error Responses

### Unauthorized (401)

```json theme={null}
{
  "success": false,
  "message": "Unauthorized"
}
```

### Not Found (404)

```json theme={null}
{
  "success": false,
  "message": "Holiday List not found."
}
```

### Conflict (409)

```json theme={null}
{
  "success": false,
  "message": "Cannot delete Holiday List because it is currently associated with one or more active campaigns."
}
```

### Internal Server Error (500)

```json theme={null}
{
  "success": false,
  "message": "Failed to delete Holiday List."
}
```