> For the complete documentation index, see [llms.txt](https://docs.api.intratool.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.api.intratool.de/api-reference/calendar/deleted-repeating-calendar-events.md).

# DeletedRepeatingCalendarEvents

## Introduction

`DeletedRepeatingCalendarEvents` exclude individual occurrence dates from a recurring [CalendarEvent](/api-reference/calendar/calendar-events.md) while retaining the event series.

## List

List excluded recurring-event dates.

**Definition**

<mark style="color:green;">`GET`</mark> `/api/deleted-repeating-calendar-events`

**Request Keys**

| Key               | Type      | Default      | Description                             |
| ----------------- | --------- | ------------ | --------------------------------------- |
| `event_id`        | `integer` | All events   | Limit records to one CalendarEvent.     |
| `selects`         | `string`  | All fields   | Comma-separated fields to return.       |
| `limit`           | `integer` | No limit     | Maximum number of records. Minimum `1`. |
| `order_field`     | `string`  | `created_at` | Field used for ordering.                |
| `order_direction` | `string`  | `asc`        | `asc` or `desc`.                        |

**Example Request**

{% tabs %}
{% tab title="PHP" %}

```php
$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('GET', '/api/deleted-repeating-calendar-events', [
    'headers' => ['Authorization' => "Bearer {accessToken}"],
    'query' => [
        'event_id' => 41,
        'order_field' => 'date',
        'order_direction' => 'asc',
        'limit' => 2
    ]
]);
```

{% endtab %}
{% endtabs %}

**Example Response**

```json
[
  {
    "id": 7,
    "user_id": 8,
    "event_id": 41,
    "date": "2026-08-11",
    "created_at": "2026-08-06 10:30:00"
  },
  {
    "id": 8,
    "user_id": 8,
    "event_id": 41,
    "date": "2026-08-13",
    "created_at": "2026-08-06 10:31:00"
  }
]
```

## Show

Show one excluded occurrence date.

**Definition**

<mark style="color:green;">`GET`</mark> `/api/deleted-repeating-calendar-events/{id}`

**Route Parameters**

| Parameter | Type      | Description                       |
| --------- | --------- | --------------------------------- |
| `id`      | `integer` | DeletedRepeatingCalendarEvent ID. |

**Request Keys**

| Key       | Type     | Default    | Description                       |
| --------- | -------- | ---------- | --------------------------------- |
| `selects` | `string` | All fields | Comma-separated fields to return. |

**Example Request**

{% tabs %}
{% tab title="PHP" %}

```php
$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('GET', '/api/deleted-repeating-calendar-events/7', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);
```

{% endtab %}
{% endtabs %}

**Example Response**

```json
{
  "id": 7,
  "user_id": 8,
  "event_id": 41,
  "date": "2026-08-11",
  "created_at": "2026-08-06 10:30:00"
}
```

## Create

Exclude one date from a recurring event.

**Definition**

<mark style="color:yellow;">`POST`</mark> `/api/deleted-repeating-calendar-events`

**Request Keys**

| Key          | Type      | Description                         |
| ------------ | --------- | ----------------------------------- |
| `event_id`\* | `integer` | Related recurring CalendarEvent ID. |
| `date`\*     | `date`    | Occurrence date to exclude.         |

Keys with `*` are required.

**Behavior**

* `user_id` is set to the authenticated user and cannot be selected by the client.
* The Calendar list resolver omits matching generated occurrences from the event series.

**Example Request**

{% tabs %}
{% tab title="PHP" %}

```php
$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('POST', '/api/deleted-repeating-calendar-events', [
    'headers' => ['Authorization' => "Bearer {accessToken}"],
    'json' => [
        'event_id' => 41,
        'date' => '2026-08-11'
    ]
]);
```

{% endtab %}
{% endtabs %}

**Example Response**

```json
{
  "status": "success",
  "data": {
    "id": 7,
    "user_id": 8,
    "event_id": 41,
    "date": "2026-08-11",
    "created_at": "2026-08-06 10:30:00"
  }
}
```

## Delete

Restore an excluded occurrence by deleting its exclusion record.

**Definition**

<mark style="color:red;">`DELETE`</mark> `/api/deleted-repeating-calendar-events/{id}`

**Route Parameters**

| Parameter | Type      | Description                       |
| --------- | --------- | --------------------------------- |
| `id`      | `integer` | DeletedRepeatingCalendarEvent ID. |

**Example Request**

{% tabs %}
{% tab title="PHP" %}

```php
$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('DELETE', '/api/deleted-repeating-calendar-events/7', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);
```

{% endtab %}
{% endtabs %}

**Example Response**

```json
{
  "status": "success",
  "data": []
}
```