Smart Calendar Help

Add Event

Add a new event to a calendar directly without opening the UI modal. Requires title, date (YYYY-MM-DD), start and end ti

Create a new calendar with an optional name and hex color. The new calendar becomes the active calendar.

Delete a calendar and ALL its events. Cannot delete the last remaining calendar.

Delete a single event by its numeric id.

Estimate the credit cost to generate a schedule or fill calendar gaps with AI suggestions. Returns { realistic, min, max

Return a snapshot of the current Smart Calendar state: view window (start date, days shown), current calendar id, how ma

Return the full details of a single event by its numeric id.

Return all calendars with their id, name, color, and event count. Identifies which is the current (active for AI/new eve

Return events, optionally filtered by calendarId and/or a date range (YYYY-MM-DD). If no filters are given, returns all

Scroll the calendar view to start at a given date (YYYY-MM-DD). Use this to bring the user to a relevant part of their s

Reset the calendar view to start at today

Open the Add/Edit Event modal pre-filled with optional field values. Use this when you want the user to review and confi

Open the Calendar Manager modal so the user can create, rename, recolor, or delete calendars.

Rename an existing calendar by id.

Show or hide a calendar on the timeline by id. Hidden calendars still exist — their events are just not displayed.

Change how many days are visible in the timeline (1–30).

Set the active (current) calendar by id. The active calendar receives new events and is used for AI planning features.

Update fields of an existing event by id. Only the provided fields are changed — all other fields remain as-is.