Skip to main content
Glama

Save a calendar revision

apply_feed_changes
DestructiveIdempotent

Saves one revision to one existing calendar feed owned by the connected account for a user-approved schedule change. Accepts one fixed-schema change set with up to 250 event changes and/or a feed title or description change; all stored calendar changes commit together in one transaction, or none are saved. The schema declares every supported change: add creates an event; update changes selected fields or uses reset_fields to restore saved field baselines; delete marks an existing event canceled without permanently erasing it; restore reinstates that same event and may update selected fields; feed_patch changes only the calendar title or description. No dynamic operation discovery, fetched schemas, arbitrary commands or arbitrary endpoints are supported. dry_run=true validates and previews the proposed change set without saving calendar changes, advancing the revision or spending credits. The response contains the exact before/after changes and any billing quote. User approval of that exact preview is a prerequisite for saving with dry_run=false. Saving requires the returned preview_receipt and the identical feed_id, expected_revision, request_id, operations and feed_patch. The receipt binds that validated preview, not user consent. Changed proposals or expired previews require a new preview and approval; revision conflicts require current feed data and a new preview. Omitted events and fields remain unchanged. Cancellation assessment from a revised schedule requires the complete unfiltered event set; unrelated events and manual fields remain unchanged unless explicitly included in the approved changes. Uncertain event matches require user clarification. Updates address matched event IDs; a duplicate add is not an update. A recurring-series target is series_id with scope=occurrence, following or series; occurrence/following uses the original scheduled occurrence_date, including moved occurrences. reset_fields can include cancellation to restore source cancellation policy. Entire-series edits include history and all returned segments are part of the preview. Explicit null in set clears nullable fields; reset_fields restores saved baselines. expected_revision prevents overwriting concurrent changes. An uncertain save is retried with the identical request_id and payload, including the original preview_receipt, rather than a new operation. Included editing access has no credit charge or credit-consent prompt. A quoted one-credit editing window requires explicit user authorization of the deduction and resulting balance before confirm_credit_charge=true; that authorization may be added after preview. Preview approval or an automation default does not authorize credit spending. publication.status reports calendar-file preparation, not subscription access. distribution_ready reports subscription availability at the returned revision; availability may change afterward. Preview proposals are recoverable for up to one hour; expired drafts are removed automatically. Previewing temporarily stores only the exact proposed calendar fields, without writing calendar events or advancing their revision. Returned feed_id and request_id identify that exact proposal for recovery. Recovery accepts only feed_id, the original request_id, dry_run=true and recover_preview=true. Reconstructed changes, guessed identifiers and latest-preview selection are unsupported. Recovery returns the original unexpired preview and exact save_arguments without extending expiry, saving or spending credits. Saving a recovered preview requires fresh user approval of its exact changes and the returned save_arguments unchanged; confirm_credit_charge remains false without explicit authorization of the current quoted charge. Recovery is not consent. Recovery with saved=true reports an already completed save and requires no additional save. An unavailable or expired proposal requires current feed data, a new request_id, a new preview and user approval; a changed proposal is a new approval decision. Scope is limited to the connected account’s Smart Calendars AI feeds. No mailbox access, source-document retrieval, automatic source monitoring, scheduled PDF checks or document refresh is provided. Structured schedule content is supplied explicitly by the caller. Result links: subscription_open_url is the exact HTTPS handoff to the default calendar app via webcal; subscription_options_url provides Apple/default, Google, Outlook and copy-link choices; subscription_url is the copyable HTTPS calendar-file fallback; manage_url opens the feed dashboard. URL hosts, paths and tokens identify the returned resource and are not interchangeable. A filtered_subscription has its own links for that selection; top-level links remain unfiltered. Subscription access requires distribution_ready=true. Opening a link does not confirm a subscription; confirmation occurs in the user’s calendar app.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "feed_id": "<feed_id>",
      "request_id": "<request_id>"
    },
    "name": "apply_feed_changes"
  }
}

Input Schema

NameRequiredDescriptionDefault
dry_runNoTrue previews and validates the exact proposed changes without changing calendar events, advancing the revision or spending credits. The preview returns before/after changes, any billing quote and a preview_receipt. False saves the same proposal using its valid preview_receipt. The receipt proves preview integrity, not user approval; preview approval and any required credit authorization remain separate prerequisites. Defaults to false.
feed_idYesIdentity of the selected calendar, as returned in feed results.
feed_patchNoProposed calendar title and/or description changes for this revision. Omitted fields stay unchanged.
operationsNoProposed event additions, updates, cancellations or restorations for this revision, with at most 250 operations. Saved operations and feed_patch commit together or none are saved.
request_idYesOpaque, non-personal idempotency key for this operation. Identical retries retain the same key and payload to prevent duplicate changes. User identifiers, chat/session IDs, telemetry and personal data are outside this field’s scope.
preview_receiptNoOpaque receipt returned by a successful dry_run=true preview. Saving with dry_run=false requires the unchanged receipt and identical feed, revision, request_id and proposed changes. The receipt proves preview integrity, not user approval.
recover_previewNoRecovery of the exact unexpired preview by its original request_id. Requires only feed_id, the original request_id, dry_run=true and recover_preview=true; all other arguments are invalid. Recovery does not save, extend expiry or authorize a charge. Saving a recovered proposal requires fresh user approval of its returned preview. Guessed identifiers and latest-preview selection are unsupported.
expected_revisionNoLast read feed revision; prevents overwriting concurrent edits.
confirm_credit_chargeNoTrue only for explicit user authorization of the current quoted credit deduction and resulting balance. Preview approval alone, a recovered receipt or an automation default does not authorize credit spending.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changed
    • addedInput schema / properties / dry_run / description
      Added value: +"True previews and validates the exact proposed changes without changing calendar events, advancing the revision or spending credits. The preview returns before/after changes, any billing quote and a preview_receipt. False saves the same proposal using its valid preview_receipt. The receipt proves preview integrity, not user approval; preview approval and any required credit authorization remain separate prerequisites. Defaults to false."
    • addedInput schema / properties / feed_patch / description
      Added value: +"Proposed calendar title and/or description changes for this revision. Omitted fields stay unchanged."
    • addedInput schema / properties / feed_patch / properties / description / description
      Added value: +"Replacement short calendar description, or null to clear it. Conversation history and user-profile data are outside this field’s scope."
    • addedInput schema / properties / feed_patch / properties / title / description
      Added value: +"Replacement calendar title."
    • addedInput schema / properties / operations / description
      Added value: +"Proposed event additions, updates, cancellations or restorations for this revision, with at most 250 operations. Saved operations and feed_patch commit together or none are saved."
    • changedInput schema / properties / operations / items / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "event": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "assignee": {
      -            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "description": "Event notes the user intends to publish with this calendar. Chat history, credentials, health records and unrelated personal context are outside this field’s scope.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_date": {
      -            "description": "Inclusive last calendar date, YYYY-MM-DD. A bounded multi-day range represents one event unless the user requests separate events.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_actors": {
      -            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      -            "items": {
      -              "type": "string"
      -            },
      -            "maxItems": 50,
      -            "type": [
      -              "array",
      -              "null"
      -            ]
      -          },
      -          "facet_topic": {
      -            "description": "Source-grounded stable category, not the full event title. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_venue": {
      -            "description": "Source-grounded venue name. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "is_all_day": {
      -            "type": "boolean"
      -          },
      -          "location": {
      -            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. User geolocation is outside this field’s scope.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "recurrence": {
      -            "additionalProperties": false,
      -            "description": "Recurrence configuration, or null for a non-recurring event. An object represents repetition explicitly stated in the source or established by separately listed regular occurrences. A single bounded multi-day range is one occurrence with start_date/end_date. Recurrence objects require all schema fields with valid values; empty or partial objects are invalid.",
      -            "properties": {
      -              "endDate": {
      -                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "frequency": {
      -                "description": "Base recurrence frequency",
      -                "enum": [
      -                  "daily",
      -                  "weekly",
      -                  "monthly",
      -                  "yearly"
      -                ],
      -                "type": "string"
      -              },
      -              "interval": {
      -                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      -                "maximum": 999,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "monthlyType": {
      -                "description": "Type of monthly recurrence: by date or by weekday pattern",
      -                "enum": [
      -                  "dayOfMonth",
      -                  "dayOfWeek"
      -                ],
      -                "type": "string"
      -              },
      -              "occurrenceCount": {
      -                "description": "Number of occurrences before ending, or null if no occurrence limit",
      -                "minimum": 1,
      -                "type": [
      -                  "integer",
      -                  "null"
      -                ]
      -              },
      -              "selectedDaysOfMonth": {
      -                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      -                "items": {
      -                  "type": "integer"
      -                },
      -                "type": "array"
      -              },
      -              "selectedMonths": {
      -                "description": "Selected months for yearly recurrence (1-12)",
      -                "items": {
      -                  "maximum": 12,
      -                  "minimum": 1,
      -                  "type": "integer"
      -                },
      -                "type": "array"
      -              },
      -              "selectedWeekdays": {
      -                "description": "Selected weekdays for weekly recurrence",
      -                "items": {
      -                  "enum": [
      -                    "monday",
      -                    "tuesday",
      -                    "wednesday",
      -                    "thursday",
      -                    "friday",
      -                    "saturday",
      -                    "sunday"
      -                  ],
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "weekdayCategory": {
      -                "description": "Category or specific weekday for monthly/yearly patterns",
      -                "enum": [
      -                  "day",
      -                  "weekday",
      -                  "weekend",
      -                  "monday",
      -                  "tuesday",
      -                  "wednesday",
      -                  "thursday",
      -                  "friday",
      -                  "saturday",
      -                  "sunday"
      -                ],
      -                "type": "string"
      -              },
      -              "weekdayOrdinal": {
      -                "description": "Ordinal position of weekday in month",
      -                "enum": [
      -                  "first",
      -                  "second",
      -                  "third",
      -                  "fourth",
      -                  "fifth",
      -                  "last",
      -                  "secondLast"
      -                ],
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "frequency",
      -              "interval",
      -              "selectedWeekdays",
      -              "monthlyType",
      -              "selectedDaysOfMonth",
      -              "weekdayOrdinal",
      -              "weekdayCategory",
      -              "selectedMonths",
      -              "endDate",
      -              "occurrenceCount"
      -            ],
      -            "type": [
      -              "object",
      -              "null"
      -            ]
      -          },
      -          "start_date": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "start_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "timezone": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "title",
      -          "start_date",
      -          "is_all_day"
      -        ],
      -        "type": "object"
      -      },
      -      "external_key": {
      -        "description": "Source-stable, namespaced event identity, for example school-a:session-104, retained when a title or date changes. A duplicate add does not update the event; updates address the existing event_id.",
      -        "maxLength": 255,
      -        "minLength": 3,
      -        "pattern": "^[A-Za-z0-9._-]{1,64}:[^\\s\\u0000-\\u001f]{1,190}$",
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "add"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "event"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "oneOf": [
      -      {
      -        "not": {
      -          "required": [
      -            "series_id"
      -          ]
      -        },
      -        "required": [
      -          "event_id"
      -        ]
      -      },
      -      {
      -        "not": {
      -          "required": [
      -            "event_id"
      -          ]
      -        },
      -        "required": [
      -          "series_id",
      -          "scope"
      -        ]
      -      }
      -    ],
      -    "properties": {
      -      "event_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "occurrence_date": {
      -        "format": "date",
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "update"
      -      },
      -      "reset_fields": {
      -        "description": "Selected overrides whose saved baselines are restored. A field without an override stays unchanged, including values supplied when adding the event. Explicit null in set clears a nullable field; reset_fields restores its baseline. The same field in both set and reset_fields is invalid.",
      -        "items": {
      -          "enum": [
      -            "title",
      -            "description",
      -            "location",
      -            "start_date",
      -            "end_date",
      -            "start_time",
      -            "end_time",
      -            "timezone",
      -            "assignee",
      -            "facet_venue",
      -            "facet_topic",
      -            "recurrence",
      -            "is_all_day",
      -            "facet_actors",
      -            "cancellation"
      -          ]
      -        },
      -        "minItems": 1,
      -        "type": "array",
      -        "uniqueItems": true
      -      },
      -      "scope": {
      -        "enum": [
      -          "occurrence",
      -          "following",
      -          "series"
      -        ]
      -      },
      -      "series_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "set": {
      -        "additionalProperties": false,
      -        "description": "Only supplied fields change. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline.",
      -        "properties": {
      -          "assignee": {
      -            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "description": "Event notes the user intends to publish with this calendar. Chat history, credentials, health records and unrelated personal context are outside this field’s scope.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_date": {
      -            "description": "Inclusive last calendar date, YYYY-MM-DD. A bounded multi-day range represents one event unless the user requests separate events.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_actors": {
      -            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      -            "items": {
      -              "type": "string"
      -            },
      -            "maxItems": 50,
      -            "type": [
      -              "array",
      -              "null"
      -            ]
      -          },
      -          "facet_topic": {
      -            "description": "Source-grounded stable category, not the full event title. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_venue": {
      -            "description": "Source-grounded venue name. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "is_all_day": {
      -            "type": "boolean"
      -          },
      -          "location": {
      -            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. User geolocation is outside this field’s scope.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "recurrence": {
      -            "additionalProperties": false,
      -            "description": "Recurrence configuration, or null for a non-recurring event. An object represents repetition explicitly stated in the source or established by separately listed regular occurrences. A single bounded multi-day range is one occurrence with start_date/end_date. Recurrence objects require all schema fields with valid values; empty or partial objects are invalid.",
      -            "properties": {
      -              "endDate": {
      -                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "frequency": {
      -                "description": "Base recurrence frequency",
      -                "enum": [
      -                  "daily",
      -                  "weekly",
      -                  "monthly",
      -                  "yearly"
      -                ],
      -                "type": "string"
      -              },
      -              "interval": {
      -                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      -                "maximum": 999,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "monthlyType": {
      -                "description": "Type of monthly recurrence: by date or by weekday pattern",
      -                "enum": [
      -                  "dayOfMonth",
      -                  "dayOfWeek"
      -                ],
      -                "type": "string"
      -              },
      -              "occurrenceCount": {
      -                "description": "Number of occurrences before ending, or null if no occurrence limit",
      -                "minimum": 1,
      -                "type": [
      -                  "integer",
      -                  "null"
      -                ]
      -              },
      -              "selectedDaysOfMonth": {
      -                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      -                "items": {
      -                  "type": "integer"
      -                },
      -                "type": "array"
      -              },
      -              "selectedMonths": {
      -                "description": "Selected months for yearly recurrence (1-12)",
      -                "items": {
      -                  "maximum": 12,
      -                  "minimum": 1,
      -                  "type": "integer"
      -                },
      -                "type": "array"
      -              },
      -              "selectedWeekdays": {
      -                "description": "Selected weekdays for weekly recurrence",
      -                "items": {
      -                  "enum": [
      -                    "monday",
      -                    "tuesday",
      -                    "wednesday",
      -                    "thursday",
      -                    "friday",
      -                    "saturday",
      -                    "sunday"
      -                  ],
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "weekdayCategory": {
      -                "description": "Category or specific weekday for monthly/yearly patterns",
      -                "enum": [
      -                  "day",
      -                  "weekday",
      -                  "weekend",
      -                  "monday",
      -                  "tuesday",
      -                  "wednesday",
      -                  "thursday",
      -                  "friday",
      -                  "saturday",
      -                  "sunday"
      -                ],
      -                "type": "string"
      -              },
      -              "weekdayOrdinal": {
      -                "description": "Ordinal position of weekday in month",
      -                "enum": [
      -                  "first",
      -                  "second",
      -                  "third",
      -                  "fourth",
      -                  "fifth",
      -                  "last",
      -                  "secondLast"
      -                ],
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "frequency",
      -              "interval",
      -              "selectedWeekdays",
      -              "monthlyType",
      -              "selectedDaysOfMonth",
      -              "weekdayOrdinal",
      -              "weekdayCategory",
      -              "selectedMonths",
      -              "endDate",
      -              "occurrenceCount"
      -            ],
      -            "type": [
      -              "object",
      -              "null"
      -            ]
      -          },
      -          "start_date": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "start_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "timezone": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "oneOf": [
      -      {
      -        "not": {
      -          "required": [
      -            "series_id"
      -          ]
      -        },
      -        "required": [
      -          "event_id"
      -        ]
      -      },
      -      {
      -        "not": {
      -          "required": [
      -            "event_id"
      -          ]
      -        },
      -        "required": [
      -          "series_id",
      -          "scope"
      -        ]
      -      }
      -    ],
      -    "properties": {
      -      "event_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "occurrence_date": {
      -        "format": "date",
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "delete"
      -      },
      -      "scope": {
      -        "enum": [
      -          "occurrence",
      -          "following",
      -          "series"
      -        ]
      -      },
      -      "series_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "oneOf": [
      -      {
      -        "not": {
      -          "required": [
      -            "series_id"
      -          ]
      -        },
      -        "required": [
      -          "event_id"
      -        ]
      -      },
      -      {
      -        "not": {
      -          "required": [
      -            "event_id"
      -          ]
      -        },
      -        "required": [
      -          "series_id",
      -          "scope"
      -        ]
      -      }
      -    ],
      -    "properties": {
      -      "event_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "occurrence_date": {
      -        "format": "date",
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "restore"
      -      },
      -      "scope": {
      -        "enum": [
      -          "occurrence",
      -          "following",
      -          "series"
      -        ]
      -      },
      -      "series_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "set": {
      -        "additionalProperties": false,
      -        "description": "Only supplied fields change. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline.",
      -        "properties": {
      -          "assignee": {
      -            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "description": "Event notes the user intends to publish with this calendar. Chat history, credentials, health records and unrelated personal context are outside this field’s scope.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_date": {
      -            "description": "Inclusive last calendar date, YYYY-MM-DD. A bounded multi-day range represents one event unless the user requests separate events.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_actors": {
      -            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      -            "items": {
      -              "type": "string"
      -            },
      -            "maxItems": 50,
      -            "type": [
      -              "array",
      -              "null"
      -            ]
      -          },
      -          "facet_topic": {
      -            "description": "Source-grounded stable category, not the full event title. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_venue": {
      -            "description": "Source-grounded venue name. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "is_all_day": {
      -            "type": "boolean"
      -          },
      -          "location": {
      -            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. User geolocation is outside this field’s scope.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "recurrence": {
      -            "additionalProperties": false,
      -            "description": "Recurrence configuration, or null for a non-recurring event. An object represents repetition explicitly stated in the source or established by separately listed regular occurrences. A single bounded multi-day range is one occurrence with start_date/end_date. Recurrence objects require all schema fields with valid values; empty or partial objects are invalid.",
      -            "properties": {
      -              "endDate": {
      -                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "frequency": {
      -                "description": "Base recurrence frequency",
      -                "enum": [
      -                  "daily",
      -                  "weekly",
      -                  "monthly",
      -                  "yearly"
      -                ],
      -                "type": "string"
      -              },
      -              "interval": {
      -                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      -                "maximum": 999,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "monthlyType": {
      -                "description": "Type of monthly recurrence: by date or by weekday pattern",
      -                "enum": [
      -                  "dayOfMonth",
      -                  "dayOfWeek"
      -                ],
      -                "type": "string"
      -              },
      -              "occurrenceCount": {
      -                "description": "Number of occurrences before ending, or null if no occurrence limit",
      -                "minimum": 1,
      -                "type": [
      -                  "integer",
      -                  "null"
      -                ]
      -              },
      -              "selectedDaysOfMonth": {
      -                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      -                "items": {
      -                  "type": "integer"
      -                },
      -                "type": "array"
      -              },
      -              "selectedMonths": {
      -                "description": "Selected months for yearly recurrence (1-12)",
      -                "items": {
      -                  "maximum": 12,
      -                  "minimum": 1,
      -                  "type": "integer"
      -                },
      -                "type": "array"
      -              },
      -              "selectedWeekdays": {
      -                "description": "Selected weekdays for weekly recurrence",
      -                "items": {
      -                  "enum": [
      -                    "monday",
      -                    "tuesday",
      -                    "wednesday",
      -                    "thursday",
      -                    "friday",
      -                    "saturday",
      -                    "sunday"
      -                  ],
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "weekdayCategory": {
      -                "description": "Category or specific weekday for monthly/yearly patterns",
      -                "enum": [
      -                  "day",
      -                  "weekday",
      -                  "weekend",
      -                  "monday",
      -                  "tuesday",
      -                  "wednesday",
      -                  "thursday",
      -                  "friday",
      -                  "saturday",
      -                  "sunday"
      -                ],
      -                "type": "string"
      -              },
      -              "weekdayOrdinal": {
      -                "description": "Ordinal position of weekday in month",
      -                "enum": [
      -                  "first",
      -                  "second",
      -                  "third",
      -                  "fourth",
      -                  "fifth",
      -                  "last",
      -                  "secondLast"
      -                ],
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "frequency",
      -              "interval",
      -              "selectedWeekdays",
      -              "monthlyType",
      -              "selectedDaysOfMonth",
      -              "weekdayOrdinal",
      -              "weekdayCategory",
      -              "selectedMonths",
      -              "endDate",
      -              "occurrenceCount"
      -            ],
      -            "type": [
      -              "object",
      -              "null"
      -            ]
      -          },
      -          "start_date": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "start_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "timezone": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "event": {
      +        "additionalProperties": false,
      +        "description": "Structured calendar fields for one event from the reviewed schedule.",
      +        "properties": {
      +          "assignee": {
      +            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "description": "Event notes the user intends to publish with this calendar. Chat history, credentials, health records and unrelated personal context are outside this field’s scope.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_date": {
      +            "description": "Inclusive last calendar date, YYYY-MM-DD. A bounded multi-day range represents one event unless the user requests separate events.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_time": {
      +            "description": "Local event end time in HH:mm format, on end_date when supplied or start_date otherwise. All-day events have no clock time.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_actors": {
      +            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "maxItems": 50,
      +            "type": [
      +              "array",
      +              "null"
      +            ]
      +          },
      +          "facet_topic": {
      +            "description": "Source-grounded stable category, not the full event title. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_venue": {
      +            "description": "Source-grounded venue name. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "is_all_day": {
      +            "description": "True for an all-day calendar event with dates and no clock times; false for a timed event with a local start time and optional end time.",
      +            "type": "boolean"
      +          },
      +          "location": {
      +            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. User geolocation is outside this field’s scope.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "recurrence": {
      +            "additionalProperties": false,
      +            "description": "Recurrence configuration, or null for a non-recurring event. An object represents repetition explicitly stated in the source or established by separately listed regular occurrences. A single bounded multi-day range is one occurrence with start_date/end_date. Recurrence objects require all schema fields with valid values; empty or partial objects are invalid.",
      +            "properties": {
      +              "endDate": {
      +                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "frequency": {
      +                "description": "Base recurrence frequency",
      +                "enum": [
      +                  "daily",
      +                  "weekly",
      +                  "monthly",
      +                  "yearly"
      +                ],
      +                "type": "string"
      +              },
      +              "interval": {
      +                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      +                "maximum": 999,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "monthlyType": {
      +                "description": "Type of monthly recurrence: by date or by weekday pattern",
      +                "enum": [
      +                  "dayOfMonth",
      +                  "dayOfWeek"
      +                ],
      +                "type": "string"
      +              },
      +              "occurrenceCount": {
      +                "description": "Number of occurrences before ending, or null if no occurrence limit",
      +                "minimum": 1,
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "selectedDaysOfMonth": {
      +                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      +                "items": {
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedMonths": {
      +                "description": "Selected months for yearly recurrence (1-12)",
      +                "items": {
      +                  "maximum": 12,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedWeekdays": {
      +                "description": "Selected weekdays for weekly recurrence",
      +                "items": {
      +                  "enum": [
      +                    "monday",
      +                    "tuesday",
      +                    "wednesday",
      +                    "thursday",
      +                    "friday",
      +                    "saturday",
      +                    "sunday"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "weekdayCategory": {
      +                "description": "Category or specific weekday for monthly/yearly patterns",
      +                "enum": [
      +                  "day",
      +                  "weekday",
      +                  "weekend",
      +                  "monday",
      +                  "tuesday",
      +                  "wednesday",
      +                  "thursday",
      +                  "friday",
      +                  "saturday",
      +                  "sunday"
      +                ],
      +                "type": "string"
      +              },
      +              "weekdayOrdinal": {
      +                "description": "Ordinal position of weekday in month",
      +                "enum": [
      +                  "first",
      +                  "second",
      +                  "third",
      +                  "fourth",
      +                  "fifth",
      +                  "last",
      +                  "secondLast"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "frequency",
      +              "interval",
      +              "selectedWeekdays",
      +              "monthlyType",
      +              "selectedDaysOfMonth",
      +              "weekdayOrdinal",
      +              "weekdayCategory",
      +              "selectedMonths",
      +              "endDate",
      +              "occurrenceCount"
      +            ],
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "start_date": {
      +            "description": "Event start date in YYYY-MM-DD format, using the event timezone for timed events.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "start_time": {
      +            "description": "Local event start time in HH:mm format. All-day events have no clock time.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "timezone": {
      +            "description": "IANA timezone for the event local dates and times, for example Europe/Berlin or UTC.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "description": "Event title from the supplied schedule.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "title",
      +          "start_date",
      +          "is_all_day"
      +        ],
      +        "type": "object"
      +      },
      +      "external_key": {
      +        "description": "Source-stable, namespaced event identity, for example school-a:session-104, retained when a title or date changes. A duplicate add does not update the event; updates address the existing event_id.",
      +        "maxLength": 255,
      +        "minLength": 3,
      +        "pattern": "^[A-Za-z0-9._-]{1,64}:[^\\s\\u0000-\\u001f]{1,190}$",
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "add",
      +        "description": "Adds a new event using the supplied event fields and optional source-stable external_key."
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "event"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "oneOf": [
      +      {
      +        "not": {
      +          "required": [
      +            "series_id"
      +          ]
      +        },
      +        "required": [
      +          "event_id"
      +        ]
      +      },
      +      {
      +        "not": {
      +          "required": [
      +            "event_id"
      +          ]
      +        },
      +        "required": [
      +          "series_id",
      +          "scope"
      +        ]
      +      }
      +    ],
      +    "properties": {
      +      "event_id": {
      +        "description": "Identity of the existing event returned with the calendar event data. An event target is an alternative to series_id and scope.",
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "occurrence_date": {
      +        "description": "Original scheduled occurrence date in YYYY-MM-DD format for occurrence or following scope, including when the occurrence has moved.",
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "update",
      +        "description": "Updates selected fields or resets selected overrides on an existing event or recurring-series target."
      +      },
      +      "reset_fields": {
      +        "description": "Selected overrides whose saved baselines are restored. A field without an override stays unchanged, including values supplied when adding the event. Explicit null in set clears a nullable field; reset_fields restores its baseline. The same field in both set and reset_fields is invalid.",
      +        "items": {
      +          "enum": [
      +            "title",
      +            "description",
      +            "location",
      +            "start_date",
      +            "end_date",
      +            "start_time",
      +            "end_time",
      +            "timezone",
      +            "assignee",
      +            "facet_venue",
      +            "facet_topic",
      +            "recurrence",
      +            "is_all_day",
      +            "facet_actors",
      +            "cancellation"
      +          ]
      +        },
      +        "minItems": 1,
      +        "type": "array",
      +        "uniqueItems": true
      +      },
      +      "scope": {
      +        "description": "Extent of a series change: occurrence affects one occurrence, following affects that occurrence and later ones, and series affects the entire series including history.",
      +        "enum": [
      +          "occurrence",
      +          "following",
      +          "series"
      +        ]
      +      },
      +      "series_id": {
      +        "description": "Identity of the recurring series returned with the calendar event data. A series target is an alternative to event_id.",
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "set": {
      +        "additionalProperties": false,
      +        "description": "Only supplied fields change. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline.",
      +        "properties": {
      +          "assignee": {
      +            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "description": "Event notes the user intends to publish with this calendar. Chat history, credentials, health records and unrelated personal context are outside this field’s scope.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_date": {
      +            "description": "Inclusive last calendar date, YYYY-MM-DD. A bounded multi-day range represents one event unless the user requests separate events.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_time": {
      +            "description": "Local event end time in HH:mm format, on end_date when supplied or start_date otherwise. All-day events have no clock time.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_actors": {
      +            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "maxItems": 50,
      +            "type": [
      +              "array",
      +              "null"
      +            ]
      +          },
      +          "facet_topic": {
      +            "description": "Source-grounded stable category, not the full event title. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_venue": {
      +            "description": "Source-grounded venue name. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "is_all_day": {
      +            "description": "True for an all-day calendar event with dates and no clock times; false for a timed event with a local start time and optional end time.",
      +            "type": "boolean"
      +          },
      +          "location": {
      +            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. User geolocation is outside this field’s scope.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "recurrence": {
      +            "additionalProperties": false,
      +            "description": "Recurrence configuration, or null for a non-recurring event. An object represents repetition explicitly stated in the source or established by separately listed regular occurrences. A single bounded multi-day range is one occurrence with start_date/end_date. Recurrence objects require all schema fields with valid values; empty or partial objects are invalid.",
      +            "properties": {
      +              "endDate": {
      +                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "frequency": {
      +                "description": "Base recurrence frequency",
      +                "enum": [
      +                  "daily",
      +                  "weekly",
      +                  "monthly",
      +                  "yearly"
      +                ],
      +                "type": "string"
      +              },
      +              "interval": {
      +                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      +                "maximum": 999,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "monthlyType": {
      +                "description": "Type of monthly recurrence: by date or by weekday pattern",
      +                "enum": [
      +                  "dayOfMonth",
      +                  "dayOfWeek"
      +                ],
      +                "type": "string"
      +              },
      +              "occurrenceCount": {
      +                "description": "Number of occurrences before ending, or null if no occurrence limit",
      +                "minimum": 1,
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "selectedDaysOfMonth": {
      +                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      +                "items": {
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedMonths": {
      +                "description": "Selected months for yearly recurrence (1-12)",
      +                "items": {
      +                  "maximum": 12,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedWeekdays": {
      +                "description": "Selected weekdays for weekly recurrence",
      +                "items": {
      +                  "enum": [
      +                    "monday",
      +                    "tuesday",
      +                    "wednesday",
      +                    "thursday",
      +                    "friday",
      +                    "saturday",
      +                    "sunday"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "weekdayCategory": {
      +                "description": "Category or specific weekday for monthly/yearly patterns",
      +                "enum": [
      +                  "day",
      +                  "weekday",
      +                  "weekend",
      +                  "monday",
      +                  "tuesday",
      +                  "wednesday",
      +                  "thursday",
      +                  "friday",
      +                  "saturday",
      +                  "sunday"
      +                ],
      +                "type": "string"
      +              },
      +              "weekdayOrdinal": {
      +                "description": "Ordinal position of weekday in month",
      +                "enum": [
      +                  "first",
      +                  "second",
      +                  "third",
      +                  "fourth",
      +                  "fifth",
      +                  "last",
      +                  "secondLast"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "frequency",
      +              "interval",
      +              "selectedWeekdays",
      +              "monthlyType",
      +              "selectedDaysOfMonth",
      +              "weekdayOrdinal",
      +              "weekdayCategory",
      +              "selectedMonths",
      +              "endDate",
      +              "occurrenceCount"
      +            ],
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "start_date": {
      +            "description": "Event start date in YYYY-MM-DD format, using the event timezone for timed events.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "start_time": {
      +            "description": "Local event start time in HH:mm format. All-day events have no clock time.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "timezone": {
      +            "description": "IANA timezone for the event local dates and times, for example Europe/Berlin or UTC.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "description": "Event title from the supplied schedule.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "oneOf": [
      +      {
      +        "not": {
      +          "required": [
      +            "series_id"
      +          ]
      +        },
      +        "required": [
      +          "event_id"
      +        ]
      +      },
      +      {
      +        "not": {
      +          "required": [
      +            "event_id"
      +          ]
      +        },
      +        "required": [
      +          "series_id",
      +          "scope"
      +        ]
      +      }
      +    ],
      +    "properties": {
      +      "event_id": {
      +        "description": "Identity of the existing event returned with the calendar event data. An event target is an alternative to series_id and scope.",
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "occurrence_date": {
      +        "description": "Original scheduled occurrence date in YYYY-MM-DD format for occurrence or following scope, including when the occurrence has moved.",
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "delete",
      +        "description": "Marks an existing event or recurring-series target canceled without permanently erasing it."
      +      },
      +      "scope": {
      +        "description": "Extent of a series change: occurrence affects one occurrence, following affects that occurrence and later ones, and series affects the entire series including history.",
      +        "enum": [
      +          "occurrence",
      +          "following",
      +          "series"
      +        ]
      +      },
      +      "series_id": {
      +        "description": "Identity of the recurring series returned with the calendar event data. A series target is an alternative to event_id.",
      +        "format": "uuid",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "oneOf": [
      +      {
      +        "not": {
      +          "required": [
      +            "series_id"
      +          ]
      +        },
      +        "required": [
      +          "event_id"
      +        ]
      +      },
      +      {
      +        "not": {
      +          "required": [
      +            "event_id"
      +          ]
      +        },
      +        "required": [
      +          "series_id",
      +          "scope"
      +        ]
      +      }
      +    ],
      +    "properties": {
      +      "event_id": {
      +        "description": "Identity of the existing event returned with the calendar event data. An event target is an alternative to series_id and scope.",
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "occurrence_date": {
      +        "description": "Original scheduled occurrence date in YYYY-MM-DD format for occurrence or following scope, including when the occurrence has moved.",
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "restore",
      +        "description": "Restores a canceled event or recurring-series target, optionally applying supplied field changes."
      +      },
      +      "scope": {
      +        "description": "Extent of a series change: occurrence affects one occurrence, following affects that occurrence and later ones, and series affects the entire series including history.",
      +        "enum": [
      +          "occurrence",
      +          "following",
      +          "series"
      +        ]
      +      },
      +      "series_id": {
      +        "description": "Identity of the recurring series returned with the calendar event data. A series target is an alternative to event_id.",
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "set": {
      +        "additionalProperties": false,
      +        "description": "Only supplied fields change. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline.",
      +        "properties": {
      +          "assignee": {
      +            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "description": "Event notes the user intends to publish with this calendar. Chat history, credentials, health records and unrelated personal context are outside this field’s scope.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_date": {
      +            "description": "Inclusive last calendar date, YYYY-MM-DD. A bounded multi-day range represents one event unless the user requests separate events.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_time": {
      +            "description": "Local event end time in HH:mm format, on end_date when supplied or start_date otherwise. All-day events have no clock time.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_actors": {
      +            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "maxItems": 50,
      +            "type": [
      +              "array",
      +              "null"
      +            ]
      +          },
      +          "facet_topic": {
      +            "description": "Source-grounded stable category, not the full event title. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_venue": {
      +            "description": "Source-grounded venue name. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "is_all_day": {
      +            "description": "True for an all-day calendar event with dates and no clock times; false for a timed event with a local start time and optional end time.",
      +            "type": "boolean"
      +          },
      +          "location": {
      +            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. User geolocation is outside this field’s scope.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "recurrence": {
      +            "additionalProperties": false,
      +            "description": "Recurrence configuration, or null for a non-recurring event. An object represents repetition explicitly stated in the source or established by separately listed regular occurrences. A single bounded multi-day range is one occurrence with start_date/end_date. Recurrence objects require all schema fields with valid values; empty or partial objects are invalid.",
      +            "properties": {
      +              "endDate": {
      +                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "frequency": {
      +                "description": "Base recurrence frequency",
      +                "enum": [
      +                  "daily",
      +                  "weekly",
      +                  "monthly",
      +                  "yearly"
      +                ],
      +                "type": "string"
      +              },
      +              "interval": {
      +                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      +                "maximum": 999,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "monthlyType": {
      +                "description": "Type of monthly recurrence: by date or by weekday pattern",
      +                "enum": [
      +                  "dayOfMonth",
      +                  "dayOfWeek"
      +                ],
      +                "type": "string"
      +              },
      +              "occurrenceCount": {
      +                "description": "Number of occurrences before ending, or null if no occurrence limit",
      +                "minimum": 1,
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "selectedDaysOfMonth": {
      +                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      +                "items": {
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedMonths": {
      +                "description": "Selected months for yearly recurrence (1-12)",
      +                "items": {
      +                  "maximum": 12,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedWeekdays": {
      +                "description": "Selected weekdays for weekly recurrence",
      +                "items": {
      +                  "enum": [
      +                    "monday",
      +                    "tuesday",
      +                    "wednesday",
      +                    "thursday",
      +                    "friday",
      +                    "saturday",
      +                    "sunday"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "weekdayCategory": {
      +                "description": "Category or specific weekday for monthly/yearly patterns",
      +                "enum": [
      +                  "day",
      +                  "weekday",
      +                  "weekend",
      +                  "monday",
      +                  "tuesday",
      +                  "wednesday",
      +                  "thursday",
      +                  "friday",
      +                  "saturday",
      +                  "sunday"
      +                ],
      +                "type": "string"
      +              },
      +              "weekdayOrdinal": {
      +                "description": "Ordinal position of weekday in month",
      +                "enum": [
      +                  "first",
      +                  "second",
      +                  "third",
      +                  "fourth",
      +                  "fifth",
      +                  "last",
      +                  "secondLast"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "frequency",
      +              "interval",
      +              "selectedWeekdays",
      +              "monthlyType",
      +              "selectedDaysOfMonth",
      +              "weekdayOrdinal",
      +              "weekdayCategory",
      +              "selectedMonths",
      +              "endDate",
      +              "occurrenceCount"
      +            ],
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "start_date": {
      +            "description": "Event start date in YYYY-MM-DD format, using the event timezone for timed events.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "start_time": {
      +            "description": "Local event start time in HH:mm format. All-day events have no clock time.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "timezone": {
      +            "description": "IANA timezone for the event local dates and times, for example Europe/Berlin or UTC.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "description": "Event title from the supplied schedule.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed6 schema fields changed
    • addedInput schema / properties / confirm_credit_charge / description
      Added value: +"True only for explicit user authorization of the current quoted credit deduction and resulting balance. Preview approval alone, a recovered receipt or an automation default does not authorize credit spending."
    • changedInput schema / properties / feed_id / description
      Previous value: -"Feed identity returned by a previous feed tool; used to address the selected calendar only."New value: +"Identity of the selected calendar, as returned in feed results."
    • changedInput schema / properties / operations / items / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "event": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "assignee": {
      -            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_date": {
      -            "description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_actors": {
      -            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "items": {
      -              "type": "string"
      -            },
      -            "maxItems": 50,
      -            "type": [
      -              "array",
      -              "null"
      -            ]
      -          },
      -          "facet_topic": {
      -            "description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_venue": {
      -            "description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "is_all_day": {
      -            "type": "boolean"
      -          },
      -          "location": {
      -            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "recurrence": {
      -            "additionalProperties": false,
      -            "description": "Recurrence configuration for the event. MUST be null (not empty object) for non-recurring events. Use a recurrence object only when the source explicitly states repetition or separately lists multiple same-title occurrences that establish a regular pattern. A single bounded date range is one event occurrence, not recurrence; preserve its first and last dates in startDate/endDate. For recurring events, ALL fields are required with valid values (no empty strings, no partial objects).",
      -            "properties": {
      -              "endDate": {
      -                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "frequency": {
      -                "description": "Base recurrence frequency",
      -                "enum": [
      -                  "daily",
      -                  "weekly",
      -                  "monthly",
      -                  "yearly"
      -                ],
      -                "type": "string"
      -              },
      -              "interval": {
      -                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      -                "maximum": 999,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "monthlyType": {
      -                "description": "Type of monthly recurrence: by date or by weekday pattern",
      -                "enum": [
      -                  "dayOfMonth",
      -                  "dayOfWeek"
      -                ],
      -                "type": "string"
      -              },
      -              "occurrenceCount": {
      -                "description": "Number of occurrences before ending, or null if no occurrence limit",
      -                "minimum": 1,
      -                "type": [
      -                  "integer",
      -                  "null"
      -                ]
      -              },
      -              "selectedDaysOfMonth": {
      -                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      -                "items": {
      -                  "type": "integer"
      -                },
      -                "type": "array"
      -              },
      -              "selectedMonths": {
      -                "description": "Selected months for yearly recurrence (1-12)",
      -                "items": {
      -                  "maximum": 12,
      -                  "minimum": 1,
      -                  "type": "integer"
      -                },
      -                "type": "array"
      -              },
      -              "selectedWeekdays": {
      -                "description": "Selected weekdays for weekly recurrence",
      -                "items": {
      -                  "enum": [
      -                    "monday",
      -                    "tuesday",
      -                    "wednesday",
      -                    "thursday",
      -                    "friday",
      -                    "saturday",
      -                    "sunday"
      -                  ],
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "weekdayCategory": {
      -                "description": "Category or specific weekday for monthly/yearly patterns",
      -                "enum": [
      -                  "day",
      -                  "weekday",
      -                  "weekend",
      -                  "monday",
      -                  "tuesday",
      -                  "wednesday",
      -                  "thursday",
      -                  "friday",
      -                  "saturday",
      -                  "sunday"
      -                ],
      -                "type": "string"
      -              },
      -              "weekdayOrdinal": {
      -                "description": "Ordinal position of weekday in month",
      -                "enum": [
      -                  "first",
      -                  "second",
      -                  "third",
      -                  "fourth",
      -                  "fifth",
      -                  "last",
      -                  "secondLast"
      -                ],
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "frequency",
      -              "interval",
      -              "selectedWeekdays",
      -              "monthlyType",
      -              "selectedDaysOfMonth",
      -              "weekdayOrdinal",
      -              "weekdayCategory",
      -              "selectedMonths",
      -              "endDate",
      -              "occurrenceCount"
      -            ],
      -            "type": [
      -              "object",
      -              "null"
      -            ]
      -          },
      -          "start_date": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "start_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "timezone": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "title",
      -          "start_date",
      -          "is_all_day"
      -        ],
      -        "type": "object"
      -      },
      -      "external_key": {
      -        "description": "Source-stable, namespaced event identity, for example school-a:session-104. Do not derive it from a mutable title or date. A duplicate add does not update the event; use its event_id with update.",
      -        "maxLength": 255,
      -        "minLength": 3,
      -        "pattern": "^[A-Za-z0-9._-]{1,64}:[^\\s\\u0000-\\u001f]{1,190}$",
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "add"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "event"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "oneOf": [
      -      {
      -        "not": {
      -          "required": [
      -            "series_id"
      -          ]
      -        },
      -        "required": [
      -          "event_id"
      -        ]
      -      },
      -      {
      -        "not": {
      -          "required": [
      -            "event_id"
      -          ]
      -        },
      -        "required": [
      -          "series_id",
      -          "scope"
      -        ]
      -      }
      -    ],
      -    "properties": {
      -      "event_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "occurrence_date": {
      -        "format": "date",
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "update"
      -      },
      -      "reset_fields": {
      -        "description": "Remove selected overrides and restore their saved baseline. This does not clear fields: location Court 1 changed to Court 2 resets to Court 1. A field without an override stays unchanged, including values supplied when adding the event. To clear a nullable field use set with null. Do not include a field in both set and reset_fields.",
      -        "items": {
      -          "enum": [
      -            "title",
      -            "description",
      -            "location",
      -            "start_date",
      -            "end_date",
      -            "start_time",
      -            "end_time",
      -            "timezone",
      -            "assignee",
      -            "facet_venue",
      -            "facet_topic",
      -            "recurrence",
      -            "is_all_day",
      -            "facet_actors",
      -            "cancellation"
      -          ]
      -        },
      -        "minItems": 1,
      -        "type": "array",
      -        "uniqueItems": true
      -      },
      -      "scope": {
      -        "enum": [
      -          "occurrence",
      -          "following",
      -          "series"
      -        ]
      -      },
      -      "series_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "set": {
      -        "additionalProperties": false,
      -        "description": "Change only the supplied fields. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline.",
      -        "properties": {
      -          "assignee": {
      -            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_date": {
      -            "description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_actors": {
      -            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "items": {
      -              "type": "string"
      -            },
      -            "maxItems": 50,
      -            "type": [
      -              "array",
      -              "null"
      -            ]
      -          },
      -          "facet_topic": {
      -            "description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_venue": {
      -            "description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "is_all_day": {
      -            "type": "boolean"
      -          },
      -          "location": {
      -            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "recurrence": {
      -            "additionalProperties": false,
      -            "description": "Recurrence configuration for the event. MUST be null (not empty object) for non-recurring events. Use a recurrence object only when the source explicitly states repetition or separately lists multiple same-title occurrences that establish a regular pattern. A single bounded date range is one event occurrence, not recurrence; preserve its first and last dates in startDate/endDate. For recurring events, ALL fields are required with valid values (no empty strings, no partial objects).",
      -            "properties": {
      -              "endDate": {
      -                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "frequency": {
      -                "description": "Base recurrence frequency",
      -                "enum": [
      -                  "daily",
      -                  "weekly",
      -                  "monthly",
      -                  "yearly"
      -                ],
      -                "type": "string"
      -              },
      -              "interval": {
      -                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      -                "maximum": 999,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "monthlyType": {
      -                "description": "Type of monthly recurrence: by date or by weekday pattern",
      -                "enum": [
      -                  "dayOfMonth",
      -                  "dayOfWeek"
      -                ],
      -                "type": "string"
      -              },
      -              "occurrenceCount": {
      -                "description": "Number of occurrences before ending, or null if no occurrence limit",
      -                "minimum": 1,
      -                "type": [
      -                  "integer",
      -                  "null"
      -                ]
      -              },
      -              "selectedDaysOfMonth": {
      -                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      -                "items": {
      -                  "type": "integer"
      -                },
      -                "type": "array"
      -              },
      -              "selectedMonths": {
      -                "description": "Selected months for yearly recurrence (1-12)",
      -                "items": {
      -                  "maximum": 12,
      -                  "minimum": 1,
      -                  "type": "integer"
      -                },
      -                "type": "array"
      -              },
      -              "selectedWeekdays": {
      -                "description": "Selected weekdays for weekly recurrence",
      -                "items": {
      -                  "enum": [
      -                    "monday",
      -                    "tuesday",
      -                    "wednesday",
      -                    "thursday",
      -                    "friday",
      -                    "saturday",
      -                    "sunday"
      -                  ],
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "weekdayCategory": {
      -                "description": "Category or specific weekday for monthly/yearly patterns",
      -                "enum": [
      -                  "day",
      -                  "weekday",
      -                  "weekend",
      -                  "monday",
      -                  "tuesday",
      -                  "wednesday",
      -                  "thursday",
      -                  "friday",
      -                  "saturday",
      -                  "sunday"
      -                ],
      -                "type": "string"
      -              },
      -              "weekdayOrdinal": {
      -                "description": "Ordinal position of weekday in month",
      -                "enum": [
      -                  "first",
      -                  "second",
      -                  "third",
      -                  "fourth",
      -                  "fifth",
      -                  "last",
      -                  "secondLast"
      -                ],
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "frequency",
      -              "interval",
      -              "selectedWeekdays",
      -              "monthlyType",
      -              "selectedDaysOfMonth",
      -              "weekdayOrdinal",
      -              "weekdayCategory",
      -              "selectedMonths",
      -              "endDate",
      -              "occurrenceCount"
      -            ],
      -            "type": [
      -              "object",
      -              "null"
      -            ]
      -          },
      -          "start_date": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "start_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "timezone": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "oneOf": [
      -      {
      -        "not": {
      -          "required": [
      -            "series_id"
      -          ]
      -        },
      -        "required": [
      -          "event_id"
      -        ]
      -      },
      -      {
      -        "not": {
      -          "required": [
      -            "event_id"
      -          ]
      -        },
      -        "required": [
      -          "series_id",
      -          "scope"
      -        ]
      -      }
      -    ],
      -    "properties": {
      -      "event_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "occurrence_date": {
      -        "format": "date",
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "delete"
      -      },
      -      "scope": {
      -        "enum": [
      -          "occurrence",
      -          "following",
      -          "series"
      -        ]
      -      },
      -      "series_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "oneOf": [
      -      {
      -        "not": {
      -          "required": [
      -            "series_id"
      -          ]
      -        },
      -        "required": [
      -          "event_id"
      -        ]
      -      },
      -      {
      -        "not": {
      -          "required": [
      -            "event_id"
      -          ]
      -        },
      -        "required": [
      -          "series_id",
      -          "scope"
      -        ]
      -      }
      -    ],
      -    "properties": {
      -      "event_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "occurrence_date": {
      -        "format": "date",
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "restore"
      -      },
      -      "scope": {
      -        "enum": [
      -          "occurrence",
      -          "following",
      -          "series"
      -        ]
      -      },
      -      "series_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "set": {
      -        "additionalProperties": false,
      -        "description": "Change only the supplied fields. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline.",
      -        "properties": {
      -          "assignee": {
      -            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_date": {
      -            "description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_actors": {
      -            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "items": {
      -              "type": "string"
      -            },
      -            "maxItems": 50,
      -            "type": [
      -              "array",
      -              "null"
      -            ]
      -          },
      -          "facet_topic": {
      -            "description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_venue": {
      -            "description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "is_all_day": {
      -            "type": "boolean"
      -          },
      -          "location": {
      -            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "recurrence": {
      -            "additionalProperties": false,
      -            "description": "Recurrence configuration for the event. MUST be null (not empty object) for non-recurring events. Use a recurrence object only when the source explicitly states repetition or separately lists multiple same-title occurrences that establish a regular pattern. A single bounded date range is one event occurrence, not recurrence; preserve its first and last dates in startDate/endDate. For recurring events, ALL fields are required with valid values (no empty strings, no partial objects).",
      -            "properties": {
      -              "endDate": {
      -                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "frequency": {
      -                "description": "Base recurrence frequency",
      -                "enum": [
      -                  "daily",
      -                  "weekly",
      -                  "monthly",
      -                  "yearly"
      -                ],
      -                "type": "string"
      -              },
      -              "interval": {
      -                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      -                "maximum": 999,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "monthlyType": {
      -                "description": "Type of monthly recurrence: by date or by weekday pattern",
      -                "enum": [
      -                  "dayOfMonth",
      -                  "dayOfWeek"
      -                ],
      -                "type": "string"
      -              },
      -              "occurrenceCount": {
      -                "description": "Number of occurrences before ending, or null if no occurrence limit",
      -                "minimum": 1,
      -                "type": [
      -                  "integer",
      -                  "null"
      -                ]
      -              },
      -              "selectedDaysOfMonth": {
      -                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      -                "items": {
      -                  "type": "integer"
      -                },
      -                "type": "array"
      -              },
      -              "selectedMonths": {
      -                "description": "Selected months for yearly recurrence (1-12)",
      -                "items": {
      -                  "maximum": 12,
      -                  "minimum": 1,
      -                  "type": "integer"
      -                },
      -                "type": "array"
      -              },
      -              "selectedWeekdays": {
      -                "description": "Selected weekdays for weekly recurrence",
      -                "items": {
      -                  "enum": [
      -                    "monday",
      -                    "tuesday",
      -                    "wednesday",
      -                    "thursday",
      -                    "friday",
      -                    "saturday",
      -                    "sunday"
      -                  ],
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              },
      -              "weekdayCategory": {
      -                "description": "Category or specific weekday for monthly/yearly patterns",
      -                "enum": [
      -                  "day",
      -                  "weekday",
      -                  "weekend",
      -                  "monday",
      -                  "tuesday",
      -                  "wednesday",
      -                  "thursday",
      -                  "friday",
      -                  "saturday",
      -                  "sunday"
      -                ],
      -                "type": "string"
      -              },
      -              "weekdayOrdinal": {
      -                "description": "Ordinal position of weekday in month",
      -                "enum": [
      -                  "first",
      -                  "second",
      -                  "third",
      -                  "fourth",
      -                  "fifth",
      -                  "last",
      -                  "secondLast"
      -                ],
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "frequency",
      -              "interval",
      -              "selectedWeekdays",
      -              "monthlyType",
      -              "selectedDaysOfMonth",
      -              "weekdayOrdinal",
      -              "weekdayCategory",
      -              "selectedMonths",
      -              "endDate",
      -              "occurrenceCount"
      -            ],
      -            "type": [
      -              "object",
      -              "null"
      -            ]
      -          },
      -          "start_date": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "start_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "timezone": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "op"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "event": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "assignee": {
      +            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "description": "Event notes the user intends to publish with this calendar. Chat history, credentials, health records and unrelated personal context are outside this field’s scope.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_date": {
      +            "description": "Inclusive last calendar date, YYYY-MM-DD. A bounded multi-day range represents one event unless the user requests separate events.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_time": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_actors": {
      +            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "maxItems": 50,
      +            "type": [
      +              "array",
      +              "null"
      +            ]
      +          },
      +          "facet_topic": {
      +            "description": "Source-grounded stable category, not the full event title. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_venue": {
      +            "description": "Source-grounded venue name. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "is_all_day": {
      +            "type": "boolean"
      +          },
      +          "location": {
      +            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. User geolocation is outside this field’s scope.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "recurrence": {
      +            "additionalProperties": false,
      +            "description": "Recurrence configuration, or null for a non-recurring event. An object represents repetition explicitly stated in the source or established by separately listed regular occurrences. A single bounded multi-day range is one occurrence with start_date/end_date. Recurrence objects require all schema fields with valid values; empty or partial objects are invalid.",
      +            "properties": {
      +              "endDate": {
      +                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "frequency": {
      +                "description": "Base recurrence frequency",
      +                "enum": [
      +                  "daily",
      +                  "weekly",
      +                  "monthly",
      +                  "yearly"
      +                ],
      +                "type": "string"
      +              },
      +              "interval": {
      +                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      +                "maximum": 999,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "monthlyType": {
      +                "description": "Type of monthly recurrence: by date or by weekday pattern",
      +                "enum": [
      +                  "dayOfMonth",
      +                  "dayOfWeek"
      +                ],
      +                "type": "string"
      +              },
      +              "occurrenceCount": {
      +                "description": "Number of occurrences before ending, or null if no occurrence limit",
      +                "minimum": 1,
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "selectedDaysOfMonth": {
      +                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      +                "items": {
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedMonths": {
      +                "description": "Selected months for yearly recurrence (1-12)",
      +                "items": {
      +                  "maximum": 12,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedWeekdays": {
      +                "description": "Selected weekdays for weekly recurrence",
      +                "items": {
      +                  "enum": [
      +                    "monday",
      +                    "tuesday",
      +                    "wednesday",
      +                    "thursday",
      +                    "friday",
      +                    "saturday",
      +                    "sunday"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "weekdayCategory": {
      +                "description": "Category or specific weekday for monthly/yearly patterns",
      +                "enum": [
      +                  "day",
      +                  "weekday",
      +                  "weekend",
      +                  "monday",
      +                  "tuesday",
      +                  "wednesday",
      +                  "thursday",
      +                  "friday",
      +                  "saturday",
      +                  "sunday"
      +                ],
      +                "type": "string"
      +              },
      +              "weekdayOrdinal": {
      +                "description": "Ordinal position of weekday in month",
      +                "enum": [
      +                  "first",
      +                  "second",
      +                  "third",
      +                  "fourth",
      +                  "fifth",
      +                  "last",
      +                  "secondLast"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "frequency",
      +              "interval",
      +              "selectedWeekdays",
      +              "monthlyType",
      +              "selectedDaysOfMonth",
      +              "weekdayOrdinal",
      +              "weekdayCategory",
      +              "selectedMonths",
      +              "endDate",
      +              "occurrenceCount"
      +            ],
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "start_date": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "start_time": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "timezone": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "title",
      +          "start_date",
      +          "is_all_day"
      +        ],
      +        "type": "object"
      +      },
      +      "external_key": {
      +        "description": "Source-stable, namespaced event identity, for example school-a:session-104, retained when a title or date changes. A duplicate add does not update the event; updates address the existing event_id.",
      +        "maxLength": 255,
      +        "minLength": 3,
      +        "pattern": "^[A-Za-z0-9._-]{1,64}:[^\\s\\u0000-\\u001f]{1,190}$",
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "add"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "event"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "oneOf": [
      +      {
      +        "not": {
      +          "required": [
      +            "series_id"
      +          ]
      +        },
      +        "required": [
      +          "event_id"
      +        ]
      +      },
      +      {
      +        "not": {
      +          "required": [
      +            "event_id"
      +          ]
      +        },
      +        "required": [
      +          "series_id",
      +          "scope"
      +        ]
      +      }
      +    ],
      +    "properties": {
      +      "event_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "occurrence_date": {
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "update"
      +      },
      +      "reset_fields": {
      +        "description": "Selected overrides whose saved baselines are restored. A field without an override stays unchanged, including values supplied when adding the event. Explicit null in set clears a nullable field; reset_fields restores its baseline. The same field in both set and reset_fields is invalid.",
      +        "items": {
      +          "enum": [
      +            "title",
      +            "description",
      +            "location",
      +            "start_date",
      +            "end_date",
      +            "start_time",
      +            "end_time",
      +            "timezone",
      +            "assignee",
      +            "facet_venue",
      +            "facet_topic",
      +            "recurrence",
      +            "is_all_day",
      +            "facet_actors",
      +            "cancellation"
      +          ]
      +        },
      +        "minItems": 1,
      +        "type": "array",
      +        "uniqueItems": true
      +      },
      +      "scope": {
      +        "enum": [
      +          "occurrence",
      +          "following",
      +          "series"
      +        ]
      +      },
      +      "series_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "set": {
      +        "additionalProperties": false,
      +        "description": "Only supplied fields change. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline.",
      +        "properties": {
      +          "assignee": {
      +            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "description": "Event notes the user intends to publish with this calendar. Chat history, credentials, health records and unrelated personal context are outside this field’s scope.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_date": {
      +            "description": "Inclusive last calendar date, YYYY-MM-DD. A bounded multi-day range represents one event unless the user requests separate events.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_time": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_actors": {
      +            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "maxItems": 50,
      +            "type": [
      +              "array",
      +              "null"
      +            ]
      +          },
      +          "facet_topic": {
      +            "description": "Source-grounded stable category, not the full event title. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_venue": {
      +            "description": "Source-grounded venue name. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "is_all_day": {
      +            "type": "boolean"
      +          },
      +          "location": {
      +            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. User geolocation is outside this field’s scope.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "recurrence": {
      +            "additionalProperties": false,
      +            "description": "Recurrence configuration, or null for a non-recurring event. An object represents repetition explicitly stated in the source or established by separately listed regular occurrences. A single bounded multi-day range is one occurrence with start_date/end_date. Recurrence objects require all schema fields with valid values; empty or partial objects are invalid.",
      +            "properties": {
      +              "endDate": {
      +                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "frequency": {
      +                "description": "Base recurrence frequency",
      +                "enum": [
      +                  "daily",
      +                  "weekly",
      +                  "monthly",
      +                  "yearly"
      +                ],
      +                "type": "string"
      +              },
      +              "interval": {
      +                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      +                "maximum": 999,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "monthlyType": {
      +                "description": "Type of monthly recurrence: by date or by weekday pattern",
      +                "enum": [
      +                  "dayOfMonth",
      +                  "dayOfWeek"
      +                ],
      +                "type": "string"
      +              },
      +              "occurrenceCount": {
      +                "description": "Number of occurrences before ending, or null if no occurrence limit",
      +                "minimum": 1,
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "selectedDaysOfMonth": {
      +                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      +                "items": {
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedMonths": {
      +                "description": "Selected months for yearly recurrence (1-12)",
      +                "items": {
      +                  "maximum": 12,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedWeekdays": {
      +                "description": "Selected weekdays for weekly recurrence",
      +                "items": {
      +                  "enum": [
      +                    "monday",
      +                    "tuesday",
      +                    "wednesday",
      +                    "thursday",
      +                    "friday",
      +                    "saturday",
      +                    "sunday"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "weekdayCategory": {
      +                "description": "Category or specific weekday for monthly/yearly patterns",
      +                "enum": [
      +                  "day",
      +                  "weekday",
      +                  "weekend",
      +                  "monday",
      +                  "tuesday",
      +                  "wednesday",
      +                  "thursday",
      +                  "friday",
      +                  "saturday",
      +                  "sunday"
      +                ],
      +                "type": "string"
      +              },
      +              "weekdayOrdinal": {
      +                "description": "Ordinal position of weekday in month",
      +                "enum": [
      +                  "first",
      +                  "second",
      +                  "third",
      +                  "fourth",
      +                  "fifth",
      +                  "last",
      +                  "secondLast"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "frequency",
      +              "interval",
      +              "selectedWeekdays",
      +              "monthlyType",
      +              "selectedDaysOfMonth",
      +              "weekdayOrdinal",
      +              "weekdayCategory",
      +              "selectedMonths",
      +              "endDate",
      +              "occurrenceCount"
      +            ],
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "start_date": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "start_time": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "timezone": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "oneOf": [
      +      {
      +        "not": {
      +          "required": [
      +            "series_id"
      +          ]
      +        },
      +        "required": [
      +          "event_id"
      +        ]
      +      },
      +      {
      +        "not": {
      +          "required": [
      +            "event_id"
      +          ]
      +        },
      +        "required": [
      +          "series_id",
      +          "scope"
      +        ]
      +      }
      +    ],
      +    "properties": {
      +      "event_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "occurrence_date": {
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "delete"
      +      },
      +      "scope": {
      +        "enum": [
      +          "occurrence",
      +          "following",
      +          "series"
      +        ]
      +      },
      +      "series_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "oneOf": [
      +      {
      +        "not": {
      +          "required": [
      +            "series_id"
      +          ]
      +        },
      +        "required": [
      +          "event_id"
      +        ]
      +      },
      +      {
      +        "not": {
      +          "required": [
      +            "event_id"
      +          ]
      +        },
      +        "required": [
      +          "series_id",
      +          "scope"
      +        ]
      +      }
      +    ],
      +    "properties": {
      +      "event_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "occurrence_date": {
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "restore"
      +      },
      +      "scope": {
      +        "enum": [
      +          "occurrence",
      +          "following",
      +          "series"
      +        ]
      +      },
      +      "series_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "set": {
      +        "additionalProperties": false,
      +        "description": "Only supplied fields change. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline.",
      +        "properties": {
      +          "assignee": {
      +            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "description": "Event notes the user intends to publish with this calendar. Chat history, credentials, health records and unrelated personal context are outside this field’s scope.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_date": {
      +            "description": "Inclusive last calendar date, YYYY-MM-DD. A bounded multi-day range represents one event unless the user requests separate events.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_time": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_actors": {
      +            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "maxItems": 50,
      +            "type": [
      +              "array",
      +              "null"
      +            ]
      +          },
      +          "facet_topic": {
      +            "description": "Source-grounded stable category, not the full event title. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_venue": {
      +            "description": "Source-grounded venue name. Source-derived labels use the existing facet vocabulary, spelling and language. Unchanged fields retain their tags.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "is_all_day": {
      +            "type": "boolean"
      +          },
      +          "location": {
      +            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. User geolocation is outside this field’s scope.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "recurrence": {
      +            "additionalProperties": false,
      +            "description": "Recurrence configuration, or null for a non-recurring event. An object represents repetition explicitly stated in the source or established by separately listed regular occurrences. A single bounded multi-day range is one occurrence with start_date/end_date. Recurrence objects require all schema fields with valid values; empty or partial objects are invalid.",
      +            "properties": {
      +              "endDate": {
      +                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "frequency": {
      +                "description": "Base recurrence frequency",
      +                "enum": [
      +                  "daily",
      +                  "weekly",
      +                  "monthly",
      +                  "yearly"
      +                ],
      +                "type": "string"
      +              },
      +              "interval": {
      +                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      +                "maximum": 999,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "monthlyType": {
      +                "description": "Type of monthly recurrence: by date or by weekday pattern",
      +                "enum": [
      +                  "dayOfMonth",
      +                  "dayOfWeek"
      +                ],
      +                "type": "string"
      +              },
      +              "occurrenceCount": {
      +                "description": "Number of occurrences before ending, or null if no occurrence limit",
      +                "minimum": 1,
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "selectedDaysOfMonth": {
      +                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      +                "items": {
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedMonths": {
      +                "description": "Selected months for yearly recurrence (1-12)",
      +                "items": {
      +                  "maximum": 12,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedWeekdays": {
      +                "description": "Selected weekdays for weekly recurrence",
      +                "items": {
      +                  "enum": [
      +                    "monday",
      +                    "tuesday",
      +                    "wednesday",
      +                    "thursday",
      +                    "friday",
      +                    "saturday",
      +                    "sunday"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "weekdayCategory": {
      +                "description": "Category or specific weekday for monthly/yearly patterns",
      +                "enum": [
      +                  "day",
      +                  "weekday",
      +                  "weekend",
      +                  "monday",
      +                  "tuesday",
      +                  "wednesday",
      +                  "thursday",
      +                  "friday",
      +                  "saturday",
      +                  "sunday"
      +                ],
      +                "type": "string"
      +              },
      +              "weekdayOrdinal": {
      +                "description": "Ordinal position of weekday in month",
      +                "enum": [
      +                  "first",
      +                  "second",
      +                  "third",
      +                  "fourth",
      +                  "fifth",
      +                  "last",
      +                  "secondLast"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "frequency",
      +              "interval",
      +              "selectedWeekdays",
      +              "monthlyType",
      +              "selectedDaysOfMonth",
      +              "weekdayOrdinal",
      +              "weekdayCategory",
      +              "selectedMonths",
      +              "endDate",
      +              "occurrenceCount"
      +            ],
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "start_date": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "start_time": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "timezone": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedInput schema / properties / preview_receipt / description
      Previous value: -"Opaque receipt returned by a successful dry_run=true preview. Required when saving with dry_run=false. Return it unchanged with the same feed, revision, request_id and proposed changes. It is not user approval."New value: +"Opaque receipt returned by a successful dry_run=true preview. Saving with dry_run=false requires the unchanged receipt and identical feed, revision, request_id and proposed changes. The receipt proves preview integrity, not user approval."
    • changedInput schema / properties / recover_preview / description
      Previous value: -"Read the exact temporarily stored preview after losing its receipt or proposal. Requires dry_run=true and only feed_id and the original request_id; omit all other arguments. Does not save, extend expiry or authorize a charge. Show the recovered preview and obtain fresh approval before saving. Never guess a request ID or select a latest preview."New value: +"Recovery of the exact unexpired preview by its original request_id. Requires only feed_id, the original request_id, dry_run=true and recover_preview=true; all other arguments are invalid. Recovery does not save, extend expiry or authorize a charge. Saving a recovered proposal requires fresh user approval of its returned preview. Guessed identifiers and latest-preview selection are unsupported."
    • changedInput schema / properties / request_id / description
      Previous value: -"Generate an opaque key for this save and reuse it unchanged for retries, to prevent duplicate changes. Not a user identifier, chat/session ID, or telemetry. Do not include personal data."New value: +"Opaque, non-personal idempotency key for this operation. Identical retries retain the same key and payload to prevent duplicate changes. User identifiers, chat/session IDs, telemetry and personal data are outside this field’s scope."
  3. Changed1 schema field changed
    • changedInput schema / properties / operations / items / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "event": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "assignee": {
      -            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_date": {
      -            "description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_actors": {
      -            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "items": {
      -              "type": "string"
      -            },
      -            "maxItems": 50,
      -            "type": [
      -              "array",
      -              "null"
      -            ]
      -          },
      -          "facet_topic": {
      -            "description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_venue": {
      -            "description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "is_all_day": {
      -            "type": "boolean"
      -          },
      -          "location": {
      -            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "start_date": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "start_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "timezone": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "title",
      -          "start_date",
      -          "is_all_day"
      -        ],
      -        "type": "object"
      -      },
      -      "external_key": {
      -        "description": "Source-stable, namespaced event identity, for example school-a:session-104. Do not derive it from a mutable title or date. A duplicate add does not update the event; use its event_id with update.",
      -        "maxLength": 255,
      -        "minLength": 3,
      -        "pattern": "^[A-Za-z0-9._-]{1,64}:[^\\s\\u0000-\\u001f]{1,190}$",
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "add"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "event"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "event_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "update"
      -      },
      -      "reset_fields": {
      -        "description": "Remove selected overrides and restore their saved baseline. This does not clear fields: location Court 1 changed to Court 2 resets to Court 1. A field without an override stays unchanged, including values supplied when adding the event. To clear a nullable field use set with null. Do not include a field in both set and reset_fields.",
      -        "items": {
      -          "enum": [
      -            "title",
      -            "description",
      -            "location",
      -            "start_date",
      -            "end_date",
      -            "start_time",
      -            "end_time",
      -            "timezone",
      -            "assignee",
      -            "facet_venue",
      -            "facet_topic",
      -            "is_all_day",
      -            "facet_actors"
      -          ]
      -        },
      -        "minItems": 1,
      -        "type": "array",
      -        "uniqueItems": true
      -      },
      -      "set": {
      -        "additionalProperties": false,
      -        "description": "Change only the supplied fields. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline.",
      -        "properties": {
      -          "assignee": {
      -            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_date": {
      -            "description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_actors": {
      -            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "items": {
      -              "type": "string"
      -            },
      -            "maxItems": 50,
      -            "type": [
      -              "array",
      -              "null"
      -            ]
      -          },
      -          "facet_topic": {
      -            "description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_venue": {
      -            "description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "is_all_day": {
      -            "type": "boolean"
      -          },
      -          "location": {
      -            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "start_date": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "start_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "timezone": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "event_id"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "event_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "delete"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "event_id"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "event_id": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "op": {
      -        "const": "restore"
      -      },
      -      "set": {
      -        "additionalProperties": false,
      -        "description": "Change only the supplied fields. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline.",
      -        "properties": {
      -          "assignee": {
      -            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_date": {
      -            "description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "end_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_actors": {
      -            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "items": {
      -              "type": "string"
      -            },
      -            "maxItems": 50,
      -            "type": [
      -              "array",
      -              "null"
      -            ]
      -          },
      -          "facet_topic": {
      -            "description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "facet_venue": {
      -            "description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "is_all_day": {
      -            "type": "boolean"
      -          },
      -          "location": {
      -            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation.",
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "start_date": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "start_time": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "timezone": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "title": {
      -            "maxLength": 20000,
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "op",
      -      "event_id"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "event": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "assignee": {
      +            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_date": {
      +            "description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_time": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_actors": {
      +            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "maxItems": 50,
      +            "type": [
      +              "array",
      +              "null"
      +            ]
      +          },
      +          "facet_topic": {
      +            "description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_venue": {
      +            "description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "is_all_day": {
      +            "type": "boolean"
      +          },
      +          "location": {
      +            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "recurrence": {
      +            "additionalProperties": false,
      +            "description": "Recurrence configuration for the event. MUST be null (not empty object) for non-recurring events. Use a recurrence object only when the source explicitly states repetition or separately lists multiple same-title occurrences that establish a regular pattern. A single bounded date range is one event occurrence, not recurrence; preserve its first and last dates in startDate/endDate. For recurring events, ALL fields are required with valid values (no empty strings, no partial objects).",
      +            "properties": {
      +              "endDate": {
      +                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "frequency": {
      +                "description": "Base recurrence frequency",
      +                "enum": [
      +                  "daily",
      +                  "weekly",
      +                  "monthly",
      +                  "yearly"
      +                ],
      +                "type": "string"
      +              },
      +              "interval": {
      +                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      +                "maximum": 999,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "monthlyType": {
      +                "description": "Type of monthly recurrence: by date or by weekday pattern",
      +                "enum": [
      +                  "dayOfMonth",
      +                  "dayOfWeek"
      +                ],
      +                "type": "string"
      +              },
      +              "occurrenceCount": {
      +                "description": "Number of occurrences before ending, or null if no occurrence limit",
      +                "minimum": 1,
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "selectedDaysOfMonth": {
      +                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      +                "items": {
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedMonths": {
      +                "description": "Selected months for yearly recurrence (1-12)",
      +                "items": {
      +                  "maximum": 12,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedWeekdays": {
      +                "description": "Selected weekdays for weekly recurrence",
      +                "items": {
      +                  "enum": [
      +                    "monday",
      +                    "tuesday",
      +                    "wednesday",
      +                    "thursday",
      +                    "friday",
      +                    "saturday",
      +                    "sunday"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "weekdayCategory": {
      +                "description": "Category or specific weekday for monthly/yearly patterns",
      +                "enum": [
      +                  "day",
      +                  "weekday",
      +                  "weekend",
      +                  "monday",
      +                  "tuesday",
      +                  "wednesday",
      +                  "thursday",
      +                  "friday",
      +                  "saturday",
      +                  "sunday"
      +                ],
      +                "type": "string"
      +              },
      +              "weekdayOrdinal": {
      +                "description": "Ordinal position of weekday in month",
      +                "enum": [
      +                  "first",
      +                  "second",
      +                  "third",
      +                  "fourth",
      +                  "fifth",
      +                  "last",
      +                  "secondLast"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "frequency",
      +              "interval",
      +              "selectedWeekdays",
      +              "monthlyType",
      +              "selectedDaysOfMonth",
      +              "weekdayOrdinal",
      +              "weekdayCategory",
      +              "selectedMonths",
      +              "endDate",
      +              "occurrenceCount"
      +            ],
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "start_date": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "start_time": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "timezone": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "title",
      +          "start_date",
      +          "is_all_day"
      +        ],
      +        "type": "object"
      +      },
      +      "external_key": {
      +        "description": "Source-stable, namespaced event identity, for example school-a:session-104. Do not derive it from a mutable title or date. A duplicate add does not update the event; use its event_id with update.",
      +        "maxLength": 255,
      +        "minLength": 3,
      +        "pattern": "^[A-Za-z0-9._-]{1,64}:[^\\s\\u0000-\\u001f]{1,190}$",
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "add"
      +      }
      +    },
      +    "required": [
      +      "op",
      +      "event"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "oneOf": [
      +      {
      +        "not": {
      +          "required": [
      +            "series_id"
      +          ]
      +        },
      +        "required": [
      +          "event_id"
      +        ]
      +      },
      +      {
      +        "not": {
      +          "required": [
      +            "event_id"
      +          ]
      +        },
      +        "required": [
      +          "series_id",
      +          "scope"
      +        ]
      +      }
      +    ],
      +    "properties": {
      +      "event_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "occurrence_date": {
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "update"
      +      },
      +      "reset_fields": {
      +        "description": "Remove selected overrides and restore their saved baseline. This does not clear fields: location Court 1 changed to Court 2 resets to Court 1. A field without an override stays unchanged, including values supplied when adding the event. To clear a nullable field use set with null. Do not include a field in both set and reset_fields.",
      +        "items": {
      +          "enum": [
      +            "title",
      +            "description",
      +            "location",
      +            "start_date",
      +            "end_date",
      +            "start_time",
      +            "end_time",
      +            "timezone",
      +            "assignee",
      +            "facet_venue",
      +            "facet_topic",
      +            "recurrence",
      +            "is_all_day",
      +            "facet_actors",
      +            "cancellation"
      +          ]
      +        },
      +        "minItems": 1,
      +        "type": "array",
      +        "uniqueItems": true
      +      },
      +      "scope": {
      +        "enum": [
      +          "occurrence",
      +          "following",
      +          "series"
      +        ]
      +      },
      +      "series_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "set": {
      +        "additionalProperties": false,
      +        "description": "Change only the supplied fields. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline.",
      +        "properties": {
      +          "assignee": {
      +            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_date": {
      +            "description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_time": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_actors": {
      +            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "maxItems": 50,
      +            "type": [
      +              "array",
      +              "null"
      +            ]
      +          },
      +          "facet_topic": {
      +            "description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_venue": {
      +            "description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "is_all_day": {
      +            "type": "boolean"
      +          },
      +          "location": {
      +            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "recurrence": {
      +            "additionalProperties": false,
      +            "description": "Recurrence configuration for the event. MUST be null (not empty object) for non-recurring events. Use a recurrence object only when the source explicitly states repetition or separately lists multiple same-title occurrences that establish a regular pattern. A single bounded date range is one event occurrence, not recurrence; preserve its first and last dates in startDate/endDate. For recurring events, ALL fields are required with valid values (no empty strings, no partial objects).",
      +            "properties": {
      +              "endDate": {
      +                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "frequency": {
      +                "description": "Base recurrence frequency",
      +                "enum": [
      +                  "daily",
      +                  "weekly",
      +                  "monthly",
      +                  "yearly"
      +                ],
      +                "type": "string"
      +              },
      +              "interval": {
      +                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      +                "maximum": 999,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "monthlyType": {
      +                "description": "Type of monthly recurrence: by date or by weekday pattern",
      +                "enum": [
      +                  "dayOfMonth",
      +                  "dayOfWeek"
      +                ],
      +                "type": "string"
      +              },
      +              "occurrenceCount": {
      +                "description": "Number of occurrences before ending, or null if no occurrence limit",
      +                "minimum": 1,
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "selectedDaysOfMonth": {
      +                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      +                "items": {
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedMonths": {
      +                "description": "Selected months for yearly recurrence (1-12)",
      +                "items": {
      +                  "maximum": 12,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedWeekdays": {
      +                "description": "Selected weekdays for weekly recurrence",
      +                "items": {
      +                  "enum": [
      +                    "monday",
      +                    "tuesday",
      +                    "wednesday",
      +                    "thursday",
      +                    "friday",
      +                    "saturday",
      +                    "sunday"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "weekdayCategory": {
      +                "description": "Category or specific weekday for monthly/yearly patterns",
      +                "enum": [
      +                  "day",
      +                  "weekday",
      +                  "weekend",
      +                  "monday",
      +                  "tuesday",
      +                  "wednesday",
      +                  "thursday",
      +                  "friday",
      +                  "saturday",
      +                  "sunday"
      +                ],
      +                "type": "string"
      +              },
      +              "weekdayOrdinal": {
      +                "description": "Ordinal position of weekday in month",
      +                "enum": [
      +                  "first",
      +                  "second",
      +                  "third",
      +                  "fourth",
      +                  "fifth",
      +                  "last",
      +                  "secondLast"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "frequency",
      +              "interval",
      +              "selectedWeekdays",
      +              "monthlyType",
      +              "selectedDaysOfMonth",
      +              "weekdayOrdinal",
      +              "weekdayCategory",
      +              "selectedMonths",
      +              "endDate",
      +              "occurrenceCount"
      +            ],
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "start_date": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "start_time": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "timezone": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "oneOf": [
      +      {
      +        "not": {
      +          "required": [
      +            "series_id"
      +          ]
      +        },
      +        "required": [
      +          "event_id"
      +        ]
      +      },
      +      {
      +        "not": {
      +          "required": [
      +            "event_id"
      +          ]
      +        },
      +        "required": [
      +          "series_id",
      +          "scope"
      +        ]
      +      }
      +    ],
      +    "properties": {
      +      "event_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "occurrence_date": {
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "delete"
      +      },
      +      "scope": {
      +        "enum": [
      +          "occurrence",
      +          "following",
      +          "series"
      +        ]
      +      },
      +      "series_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "oneOf": [
      +      {
      +        "not": {
      +          "required": [
      +            "series_id"
      +          ]
      +        },
      +        "required": [
      +          "event_id"
      +        ]
      +      },
      +      {
      +        "not": {
      +          "required": [
      +            "event_id"
      +          ]
      +        },
      +        "required": [
      +          "series_id",
      +          "scope"
      +        ]
      +      }
      +    ],
      +    "properties": {
      +      "event_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "occurrence_date": {
      +        "format": "date",
      +        "type": "string"
      +      },
      +      "op": {
      +        "const": "restore"
      +      },
      +      "scope": {
      +        "enum": [
      +          "occurrence",
      +          "following",
      +          "series"
      +        ]
      +      },
      +      "series_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "set": {
      +        "additionalProperties": false,
      +        "description": "Change only the supplied fields. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline.",
      +        "properties": {
      +          "assignee": {
      +            "description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_date": {
      +            "description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "end_time": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_actors": {
      +            "description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "maxItems": 50,
      +            "type": [
      +              "array",
      +              "null"
      +            ]
      +          },
      +          "facet_topic": {
      +            "description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "facet_venue": {
      +            "description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "is_all_day": {
      +            "type": "boolean"
      +          },
      +          "location": {
      +            "description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation.",
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "recurrence": {
      +            "additionalProperties": false,
      +            "description": "Recurrence configuration for the event. MUST be null (not empty object) for non-recurring events. Use a recurrence object only when the source explicitly states repetition or separately lists multiple same-title occurrences that establish a regular pattern. A single bounded date range is one event occurrence, not recurrence; preserve its first and last dates in startDate/endDate. For recurring events, ALL fields are required with valid values (no empty strings, no partial objects).",
      +            "properties": {
      +              "endDate": {
      +                "description": "End date for recurrence in YYYY-MM-DD format, or null if no end date",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "frequency": {
      +                "description": "Base recurrence frequency",
      +                "enum": [
      +                  "daily",
      +                  "weekly",
      +                  "monthly",
      +                  "yearly"
      +                ],
      +                "type": "string"
      +              },
      +              "interval": {
      +                "description": "Interval between recurrences (e.g., 2 for every 2 weeks)",
      +                "maximum": 999,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "monthlyType": {
      +                "description": "Type of monthly recurrence: by date or by weekday pattern",
      +                "enum": [
      +                  "dayOfMonth",
      +                  "dayOfWeek"
      +                ],
      +                "type": "string"
      +              },
      +              "occurrenceCount": {
      +                "description": "Number of occurrences before ending, or null if no occurrence limit",
      +                "minimum": 1,
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "selectedDaysOfMonth": {
      +                "description": "Selected days of month (1-31, -1 for last day, -2 for second-last)",
      +                "items": {
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedMonths": {
      +                "description": "Selected months for yearly recurrence (1-12)",
      +                "items": {
      +                  "maximum": 12,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "type": "array"
      +              },
      +              "selectedWeekdays": {
      +                "description": "Selected weekdays for weekly recurrence",
      +                "items": {
      +                  "enum": [
      +                    "monday",
      +                    "tuesday",
      +                    "wednesday",
      +                    "thursday",
      +                    "friday",
      +                    "saturday",
      +                    "sunday"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "weekdayCategory": {
      +                "description": "Category or specific weekday for monthly/yearly patterns",
      +                "enum": [
      +                  "day",
      +                  "weekday",
      +                  "weekend",
      +                  "monday",
      +                  "tuesday",
      +                  "wednesday",
      +                  "thursday",
      +                  "friday",
      +                  "saturday",
      +                  "sunday"
      +                ],
      +                "type": "string"
      +              },
      +              "weekdayOrdinal": {
      +                "description": "Ordinal position of weekday in month",
      +                "enum": [
      +                  "first",
      +                  "second",
      +                  "third",
      +                  "fourth",
      +                  "fifth",
      +                  "last",
      +                  "secondLast"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "frequency",
      +              "interval",
      +              "selectedWeekdays",
      +              "monthlyType",
      +              "selectedDaysOfMonth",
      +              "weekdayOrdinal",
      +              "weekdayCategory",
      +              "selectedMonths",
      +              "endDate",
      +              "occurrenceCount"
      +            ],
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "start_date": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "start_time": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "timezone": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "title": {
      +            "maxLength": 20000,
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "op"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. First observed

TDQS

A4.4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations (readOnlyHint=false, destructiveHint=true, idempotentHint=true), the description discloses transaction atomicity, soft-cancel semantics for delete, preview expiry after one hour, receipt binding rules, credit-charge authorization requirements, and idempotent retry behavior with request_id. These details materially exceed what the structured annotations provide.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose is front-loaded, but the description is a very long wall of text with substantial repetition around preview approval, credit authorization, recovery, and consent. Many sentences restate schema details or repeat the same workflow constraints, so it is not appropriately sized for the task.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex mutation tool with nine parameters, nested operation schemas, and no output schema, the description covers all critical context: transaction behavior, preview/save workflow, receipt handling, revision conflicts, credit charging, recovery, and distribution semantics. Nothing essential for correct invocation appears to be missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the structured schema already documents parameters in depth. The description still adds cross-parameter semantics not captured in the schema, such as requiring identical feed_id, expected_revision, request_id, operations and feed_patch when saving with a preview_receipt, and clarifying that a duplicate add is not an update.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence states a specific verb, resource, and scope: saving one revision to one existing calendar feed owned by the connected account for a user-approved schedule change. It immediately distinguishes this from sibling read/create/deactivate/list tools by describing a revision-save operation on a fixed-schema change set.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives extensive guidance on when to use dry_run versus dry_run=false, when to recover a preview, and when fresh approval or current feed data is required. It does not explicitly name the sibling tools as alternatives (e.g., use get_feed for current data or create_feed for a new feed), so it falls short of the top score despite strong workflow context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources