اشتراک‌های تقویم
تقویم‌های دیگری که با پیوند مشترکشان می‌شوید و رویدادهایشان به‌صورت فقط‌خواندنی روی تقویم شما نمایش داده می‌شوند.
هر کدام از 5 فراخوانی را روی فضای کاری شما اجرا می‌کند.
POST /calendar/subscriptions
تقویم‌های دیگری که با پیوند مشترکشان می‌شوید و رویدادهایشان به‌صورت فقط‌خواندنی روی تقویم شما نمایش داده می‌شوند.
مشترک شدن
به calendar:write نیاز دارد. url یک پیوند https، http یا webcal به یک فایل iCalendar است، و name به‌طور پیش‌فرض همان نامی است که تقویم برای خودش گذاشته است.
curl -X POST "$OE/calendar/subscriptions" -H "$AUTH" -H 'content-type: application/json' -d '{ "url": "webcal://example.com/holidays.ics", "color": "green" }'{ "object": "calendar_subscription", "id": "csb_8d3f0a2b9c4e41f7a6b5c2d1", "name": "Public holidays", "url": "https://example.com/holidays.ics", "color": "green", "status": "active", "lastError": null, "eventCount": 24, "lastSyncedAt": "2026-10-10T12:00:03.000Z", "lastFetchedAt": "2026-10-10T12:00:03.000Z", "createdAt": "2026-10-10T12:00:01.000Z"}تقویم بی‌درنگ و سپس حدوداً هر 30 دقیقه یک بار خوانده می‌شود. GET /calendar/subscriptions اشتراک‌ها را فهرست می‌کند، PATCH /calendar/subscriptions/{id} نام یکی را تغییر می‌دهد یا color آن را عوض می‌کند، POST /calendar/subscriptions/{id}/refresh یکی را همین حالا دوباره می‌خواند، و DELETE /calendar/subscriptions/{id} آن را همراه با رویدادهایش حذف می‌کند.
پیوندی که با یک تقویم پاسخ ندهد 422 calendar_subscription_unreadable است، پیوندی که از قبل مشترکش هستید 409 calendar_subscription_exists است، و به‌روزرسانی‌ای که کمتر از یک دقیقه پس از آخرین خواندن انجام شود 429 calendar_subscription_refresh_too_soon است. status تا وقتی خواندن‌ها شکست می‌خورند failing و پس از ده شکست پیاپی stopped می‌شود، و دلیلش در lastError می‌آید.
رویدادهای یک اشتراک subscriptionId آن را در خود دارند و نمی‌توان تغییرشان داد، که 403 event_read_only است. کلیدی که به برخی نشانی‌ها یا دامنه‌ها محدود است 422 capability_unsupported است.