---
{
  "id": "platform.calendar.overview",
  "topic": "calendar",
  "title": "Calendar container and event operations overview",
  "locale": "en",
  "version": "2026-08-25",
  "summary": "Calendar reads and manages events in authorized calendars; it is a resource family, not a time-driven Agent automation.",
  "content": "Calendar is the resource family for events in user-visible, Agent-authorized calendars. Use Cron instead for scheduled Agent work. A Calendar reminder is only a platform notification attached to an event.\n\n`list_calendars` and `get_calendar` read only the intersection of triggering-user visibility and executing-Agent grants. `create_calendar` creates a native calendar for the triggering user and grants the executing Agent write access; `update_calendar` is owner-only. `delete_calendar` is owner-only and refuses default or device-mirrored calendars. `list_members` reads an authorized calendar roster when the triggering user is an administrator; membership writes remain user/CLI-only v1 operations.\n\n`list_events` returns both `events` and `kanbanEvents`; Kanban projections are read-only. `get_event` reads one real event. `create_event`, `update_event`, and `delete_event` mutate events. `export_event` returns RFC 5545 iCalendar for an authorized event or recurring instance. `create_event` may preserve a caller-supplied `icalUid`; access checks still apply.\n\n`import_ics` imports up to 500 events from raw VCALENDAR text into a mutually writable calendar. This bulk write requires UserConfirm + Strict; Action payloads are limited to 64 KiB and v1 to 2 MiB.\n\nCalendar actions record event details, not attendees or invitations; do not claim they send invitations. `delete_calendar` and `delete_event` require UserConfirm + Strict, as does `import_ics`. No Calendar action is allowed on a public surface. Registry schemas, live results, and typed runtime errors are authoritative.\n",
  "aliases": [
    "calendar",
    "calendar event",
    "meeting",
    "appointment",
    "event",
    "schedule a meeting",
    "add an event",
    "行事曆",
    "日曆",
    "會議",
    "活動",
    "行程"
  ],
  "tags": [
    "calendar",
    "overview",
    "routing"
  ],
  "relatedActions": [
    "arinova.calendar.list_calendars",
    "arinova.calendar.get_calendar",
    "arinova.calendar.create_calendar",
    "arinova.calendar.update_calendar",
    "arinova.calendar.delete_calendar",
    "arinova.calendar.list_events",
    "arinova.calendar.get_event",
    "arinova.calendar.create_event",
    "arinova.calendar.update_event",
    "arinova.calendar.delete_event",
    "arinova.calendar.import_ics",
    "arinova.calendar.export_event",
    "arinova.calendar.list_members"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/en/kb/calendar/overview/"
}
---

Calendar is the resource family for events in user-visible, Agent-authorized calendars. Use Cron instead for scheduled Agent work. A Calendar reminder is only a platform notification attached to an event.

`list_calendars` and `get_calendar` read only the intersection of triggering-user visibility and executing-Agent grants. `create_calendar` creates a native calendar for the triggering user and grants the executing Agent write access; `update_calendar` is owner-only. `delete_calendar` is owner-only and refuses default or device-mirrored calendars. `list_members` reads an authorized calendar roster when the triggering user is an administrator; membership writes remain user/CLI-only v1 operations.

`list_events` returns both `events` and `kanbanEvents`; Kanban projections are read-only. `get_event` reads one real event. `create_event`, `update_event`, and `delete_event` mutate events. `export_event` returns RFC 5545 iCalendar for an authorized event or recurring instance. `create_event` may preserve a caller-supplied `icalUid`; access checks still apply.

`import_ics` imports up to 500 events from raw VCALENDAR text into a mutually writable calendar. This bulk write requires UserConfirm + Strict; Action payloads are limited to 64 KiB and v1 to 2 MiB.

Calendar actions record event details, not attendees or invitations; do not claim they send invitations. `delete_calendar` and `delete_event` require UserConfirm + Strict, as does `import_ics`. No Calendar action is allowed on a public surface. Registry schemas, live results, and typed runtime errors are authoritative.