Kalenderabonnements
Andere Kalender, die Sie per Link abonnieren und deren Termine schreibgeschützt in Ihrem Kalender erscheinen.
Führt jeden der 5 Aufrufe in Ihrem Workspace aus.
POST /calendar/subscriptions
Andere Kalender, die Sie per Link abonnieren und deren Termine schreibgeschützt in Ihrem Kalender erscheinen.
Abonnieren
Erfordert calendar:write. url ist ein https-, http- oder webcal-Link zu einer iCalendar-Datei, und name ist standardmäßig der Name, den sich der Kalender selbst gibt.
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"}Der Kalender wird sofort gelesen und danach etwa alle 30 Minuten. GET /calendar/subscriptions listet die Abonnements auf, PATCH /calendar/subscriptions/{id} benennt eines um oder ändert seine color, POST /calendar/subscriptions/{id}/refresh liest eines jetzt erneut, und DELETE /calendar/subscriptions/{id} entfernt es mitsamt seinen Terminen.
Ein Link, der nicht mit einem Kalender antwortet, ergibt 422 calendar_subscription_unreadable, einer, den Sie bereits abonniert haben, 409 calendar_subscription_exists, und eine Aktualisierung innerhalb einer Minute nach dem letzten Lesen 429 calendar_subscription_refresh_too_soon. status wird zu failing, solange das Lesen fehlschlägt, und zu stopped nach zehn Fehlschlägen in Folge, mit dem Grund in lastError.
Termine aus einem Abonnement tragen dessen subscriptionId und lassen sich nicht ändern: Ein Versuch ergibt 403 event_read_only. Ein auf einige Adressen oder Domains beschränkter Schlüssel ergibt 422 capability_unsupported.