कैलेंडर सदस्यताएँ
वे दूसरे कैलेंडर जिनकी आप लिंक से सदस्यता लेते हैं, और जिनके इवेंट आपके कैलेंडर पर सिर्फ़ पढ़ने के लिए दिखते हैं।
5 कॉल में से कोई भी आपके वर्कस्पेस पर चलाता है।
POST /calendar/subscriptions
वे दूसरे कैलेंडर जिनकी आप लिंक से सदस्यता लेते हैं, और जिनके इवेंट आपके कैलेंडर पर सिर्फ़ पढ़ने के लिए दिखते हैं।
सदस्यता लें
calendar:write चाहिए। url किसी iCalendar फ़ाइल का https, http या webcal लिंक है, और 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 है।