Calendar

The calendar integration brings calendars into Home Assistant: a local calendar, CalDAV, Google Calendar, and more.

An automation can put an event in a calendar with calendar.create_event, and that is where it ends. Calendars that can delete an event do so only when asked from the calendar panel. Spook adds the actions to change an event, and to take it out again.

Deleting an event goes by its uid, an identifier every event has, and calendar.get_events leaves that out of what it returns. So Spook finds events the way an automation can: by their title, in a stretch of time.

Devices & entities¶

Spook does not provide any new devices or entities for this integration.

Actions¶

Spook adds the following new actions to your Home Assistant instance:

Delete event¶

Delete events from a calendar, found by their title or their uid in a stretch of time.

Events are looked for from start_date_time, which is now when you leave it out, until end_date_time or for duration, the same way calendar.get_events reads them. Every event in that stretch with exactly that summary, or that uid, or both, is deleted.

An event that repeats is found occurrence by occurrence, and only the occurrences found are deleted. Set whole_series to delete the whole series instead.

When nothing matches, nothing happens. That is not an error: “delete it if it is there” is how an automation tidies up after itself.

The response lists every event deleted, for each calendar, with its uid, recurrence_id, summary, start and end.

1
2
3
4
5
6
7
action: calendar.delete_event
target:
  entity_id: calendar.family
data:
  summary: Take the bins out
  duration:
    hours: 24

Update event¶

Change events in a calendar, found by their title or their uid in a stretch of time: a new title, a new place, or new times.

Events are found exactly the way delete event finds them. Every event found gets the changes you ask for, and keeps everything else it had: Home Assistant hands the calendar a whole event to update, so Spook carries over what you did not change.

To move an event, give it a new_start, and it keeps its length, or a new_start and a new_end, or a new_end alone to make it longer or shorter. Or move it by a shift, later, or earlier when negative. A time written without a time zone is read as Home Assistant’s own.

The response lists every event changed, for each calendar, with its uid and its new summary, start and end.

1
2
3
4
5
6
7
8
9
action: calendar.update_event
target:
  entity_id: calendar.family
data:
  summary: Dentist
  duration:
    hours: 24
  shift:
    hours: 1

Repairs¶

Spook has no repair detections for this integration.