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"
+ }
+]