Suscripciones de calendario
Otros calendarios a los que te suscribes por enlace, cuyos eventos aparecen en tu calendario en modo de solo lectura.
Ejecuta cualquiera de las 5 llamadas en tu espacio de trabajo.
POST /calendar/subscriptions
Otros calendarios a los que te suscribes por enlace, cuyos eventos aparecen en tu calendario en modo de solo lectura.
Suscribirse
Requiere calendar:write. url es un enlace https, http o webcal a un archivo iCalendar, y name toma por defecto el nombre que el calendario se da a sí mismo.
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"}El calendario se lee al momento y después cada 30 minutos aproximadamente. GET /calendar/subscriptions lista las suscripciones, PATCH /calendar/subscriptions/{id} renombra una o cambia su color, POST /calendar/subscriptions/{id}/refresh vuelve a leer una ahora, y DELETE /calendar/subscriptions/{id} la elimina con sus eventos.
Un enlace que no responde con un calendario es un 422 calendar_subscription_unreadable, uno al que ya estás suscrito, un 409 calendar_subscription_exists, y una actualización a menos de un minuto de la última lectura, un 429 calendar_subscription_refresh_too_soon. status pasa a failing mientras las lecturas fallan y a stopped tras diez fallos seguidos, con el motivo en lastError.
Los eventos de una suscripción llevan su subscriptionId y no se pueden cambiar: intentarlo es un 403 event_read_only. Una clave limitada a algunas direcciones o dominios es un 422 capability_unsupported.