Calendar Link
CalendarLink publishes a calendar's business hours and availability blocks as an RFC 5545 iCalendar feed. Each link has its own URL-safe token; deleting the link immediately revokes access.
| Field | Type | Notes |
|---|---|---|
calendarLinkId | int | Primary key |
organizationId | int | Organization that owns the calendar |
calendarId | int | Published calendar |
label | string? | User-facing link label |
isSystem | boolean | true for links managed by an organization connection |
organizationConnectionId | int? | Connection controlling a system link |
tokenHint | string | Last four token characters; the full token is never returned after issuance |
lastFetchedAt | datetime? | Last successful authorized feed request |
The feed endpoint is GET /api/calendar-feed/v1/orgs/{organizationId}/{token}/calendar_{calendarId}.ics. It is anonymous because the token is the credential, supports ETag/If-None-Match, and returns 304 when unchanged. Disabling an organization connection disables all of its system links.
Deleting a calendar is rejected while it has a system link; unlink the organization connection first.