Abonnements à des calendriers
D’autres calendriers auxquels vous vous abonnez par lien, et dont les événements s’affichent en lecture seule dans votre calendrier.
Exécute l'un des 5 appels sur votre espace de travail.
POST /calendar/subscriptions
D’autres calendriers auxquels vous vous abonnez par lien, et dont les événements s’affichent en lecture seule dans votre calendrier.
S’abonner
Nécessite calendar:write. url est un lien https, http ou webcal vers un fichier iCalendar, et name prend par défaut le nom que le calendrier se donne.
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"}Le calendrier est lu tout de suite, puis environ toutes les 30 minutes. GET /calendar/subscriptions liste les abonnements, PATCH /calendar/subscriptions/{id} en renomme un ou change sa color, POST /calendar/subscriptions/{id}/refresh en relit un maintenant, et DELETE /calendar/subscriptions/{id} le supprime avec ses événements.
Un lien qui ne répond pas par un calendrier renvoie 422 calendar_subscription_unreadable, un lien auquel vous êtes déjà abonné 409 calendar_subscription_exists, et une actualisation moins d’une minute après la dernière lecture 429 calendar_subscription_refresh_too_soon. status passe à failing tant que les lectures échouent et à stopped après dix échecs d’affilée, avec la raison dans lastError.
Les événements d’un abonnement portent son subscriptionId et ne peuvent pas être modifiés : une tentative renvoie 403 event_read_only. Une clé limitée à certaines adresses ou certains domaines renvoie 422 capability_unsupported.