actionenumобязательный
The operation to perform.
idstring
The unique identifier of the reminder (REQUIRED for update, delete; optional for read to get single reminder).
titlestring
The title of the reminder (REQUIRED for create, optional for update).
startDatestring
Start date. RECOMMENDED format: 'YYYY-MM-DD HH:mm:ss' (local time without timezone). Also supports 'YYYY-MM-DD' and ISO 8601 with timezone.
dueDatestring
Due date. RECOMMENDED format: 'YYYY-MM-DD HH:mm:ss' (local time without timezone, e.g., '2025-11-04 18:00:00'). Also supports: 'YYYY-MM-DD', 'YYYY-MM-DDTHH:mm:ss', or ISO 8601 with timezone (e.g., '2025-10-30T04:00:00Z'). When no timezone is specified, the time is interpreted as local time.
completionDatestring
Completion date/time (for update). When provided, sets the completion date of the reminder.
notestring
Additional notes for the reminder.
locationstring
Location text for the reminder (EKCalendarItem.location). Not the same as a location-based trigger.
urlstring
A URL to associate with the reminder.
completedboolean
The completion status of the reminder (for update).
priorityenum
Priority level: 0=none, 1=high, 5=medium, 9=low (for create/update).
alarmsobject[]
Alarms for the reminder (EKCalendarItem.alarms). Each alarm must specify exactly one of relativeOffset (seconds), absoluteDate, or locationTrigger.
clearAlarmsboolean
Set to true to remove all alarms from the reminder.
targetListstring
The name of the list for create or update operations.
filterListstring
Filter reminders by a specific list name.
showCompletedboolean
Include completed reminders in the results.
searchstring
A search term to filter reminders by title or notes.
dueWithinenum
Filter reminders by a due date range.
filterPriorityenum
Filter reminders by priority level.
filterRecurringboolean
Filter to only show recurring reminders when true.
recurrenceobject
Recurrence rule for repeating reminders. Set to create/update recurring reminders.
recurrenceRulesobject[]
Recurrence rules for repeating reminders (EKCalendarItem.recurrenceRules).
clearRecurrenceboolean
Set to true to remove recurrence from an existing reminder (for update).
filterLocationBasedboolean
Filter to only show location-based reminders when true.
locationTriggerobject
Location trigger for geofence-based reminders. Reminder will fire when entering or leaving the specified location.
clearLocationTriggerboolean
Set to true to remove location trigger from an existing reminder (for update).
filterTagsstring[]
Filter reminders by tags (must have ALL specified tags). Example: ["work", "urgent"]
tagsstring[]
Tags to set on the reminder (for create). Replaces any existing tags. Example: ["work", "urgent"]
addTagsstring[]
Tags to add to the reminder (for update). Merges with existing tags. Example: ["followup"]
removeTagsstring[]
Tags to remove from the reminder (for update). Example: ["urgent"]
subtasksstring[]
Initial subtasks to create with the reminder (for create action). Provide an array of subtask titles. Example: ["Buy milk", "Get eggs", "Pick up bread"]