Sign in
organizations

Trigger a sync of every calendar in the organization

Changed on

POST /organizations/{id}/sync-calendars/ — enqueue a sync of all calendars.

Each active calendar in the organization is synced using its owner's linked account. Calendars without an owner or a linked provider account are reported under skipped rather than failing the whole request.

Body (CalendarSyncRequestSerializer): start_datetime, end_datetime (required ISO 8601) and should_update_events. Returns HTTP 202 with {"synced": [...], "skipped": [...]}.

post/organizations/{id}/sync-calendars/

Request

  • The document declares no server URL.
  • Auth: one of:
    • HTTP bearer
    • API key in cookie sessionid

Path parameters

idstring required

Headers

X-Organization-Idstring

Selects the active organization for this request. Optional for callers that belong to exactly one active organization — the single membership is resolved implicitly. Required when the caller has two or more active memberships; omitting it in that case returns 400. If the header names an organization the caller is not an active member of, the server returns 403.

Request body

start_datetimestring date-time required
end_datetimestring date-time required
should_update_eventsboolean

Response

Sync enqueued. Body: {synced: [calendar_id, ...], skipped: [{calendar_id, reason}, ...]}.

Changes