Calendar Subscriptions
External calendars subscribed to by ICS URL — the inbound mirror of Calendar Feed. Each user can hold several subscriptions (Google/Outlook/Apple secret addresses), each with a display colour and visibility toggle; their events are expanded server-side (recurrences included, times converted to practice wall clock) and overlaid on the task calendar. Feeds are fetched on demand through a 30-minute server-side cache with SSRF-guarded URLs.
-
GET List Calendar SubscriptionsLists the current user's external calendar subscriptions. Unpaged — each user holds a handful at most./tenants/{tenant}/calendar-subscriptions
-
POST Create Calendar SubscriptionSubscribes the current user to an external calendar by ICS URL. The URL is validated by fetching and parsing it, so a bad link fails here./tenants/{tenant}/calendar-subscriptions
-
GET List External Calendar EventsExpands the current user's visible subscriptions into concrete events for a date window (100 days at most). A feed that fails to fetch contributes no .../tenants/{tenant}/calendar-subscriptions/events
-
GET Get Calendar SubscriptionGets one of the current user's calendar subscriptions by code./tenants/{tenant}/calendar-subscriptions/{code}
-
PUT Update Calendar SubscriptionUpdates one of the current user's calendar subscriptions. A changed URL is re-validated by fetching it./tenants/{tenant}/calendar-subscriptions/{code}
-
DELETE Delete Calendar SubscriptionDeletes one of the current user's calendar subscriptions./tenants/{tenant}/calendar-subscriptions/{code}
-
POST Refresh Calendar SubscriptionFetches the subscription's feed again immediately, bypassing the server-side cache. A failed fetch is recorded on the subscription and returned as a 4.../tenants/{tenant}/calendar-subscriptions/{code}/refresh